tobias/nixpkgs
1
0
Fork 0
mirror of https://github.com/NixOS/nixpkgs.git synced 2025-11-14 19:58:30 +01:00
Code Issues Packages Projects Releases Wiki Activity
nixpkgs/nixos/doc/manual/from_md
History
pennae df09c21fb2 nixos/documentation: deprecate docbook option docs 
following the plan in https://github.com/NixOS/nixpkgs/pull/189318#discussion_r961764451

also adds an activation script to print the warning during activation
instead of during build, otherwise folks using the new CLI that hides
build logs by default might never see the warning.
2023-01-22 17:08:40 +01:00
..
administration nixos/doc: bump Pandoc 2022-12-27 17:23:25 +01:00
configuration services.openssh: support freeform settings (#193757) 2023-01-15 16:32:46 +01:00
development nixos/manual: mention that module chapters should use markdown 2023-01-10 10:31:59 +01:00
installation doc/installation: fix incorrect channel link 2023-01-03 15:24:36 -05:00
release-notes nixos/documentation: deprecate docbook option docs 2023-01-22 17:08:40 +01:00
contributing-to-this-manual.chapter.xml nixos/manpages: Explain -I option and how to build manpages 2022-12-11 11:00:06 +01:00
README.md

README.md

This directory is temporarily needed while we transition the manual to CommonMark. It stores the output of the ../md-to-db.sh script that converts CommonMark files back to DocBook.

We are choosing to convert the Markdown to DocBook at authoring time instead of manual building time, because we do not want the pandoc toolchain to become part of the NixOS closure.

Do not edit the DocBook files inside this directory or its subdirectories. Instead, edit the corresponding .md file in the normal manual directories, and run ../md-to-db.sh to update the file here.