nixpkgs/nixos/doc/manual/from_md
Luflosi 78f357f134
nixos/kubo: make the configuration options idempotent
Without this commit, unsetting any of the `services.kubo.settings` options does not reset the value back to the default. This commit gets rid of this statefulness.
This is achieved by generating the default config, applying the user specified config options to it and then patching the `Identity` and `Pinning` config options from the old config back in. This new config is then applied using `ipfs config replace`.
The only remaining stateful parts of the config are the `Identity` and `Pinning.RemoteServices` settings as those can't be changed with `ipfs config replace`. `Pinning.RemoteServices` also contains secrets that shouldn't be in the Nix store. Setting these options wasn't possible before as it would result in an error when the daemon tried to start. I added some assertions to guard against this case.
2023-01-24 16:33:03 +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: clarify mk{Enable,Package}Option MD usage 2023-01-22 17:08:40 +01:00
installation doc/installation: fix incorrect channel link 2023-01-03 15:24:36 -05:00
release-notes nixos/kubo: make the configuration options idempotent 2023-01-24 16:33:03 +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

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.