Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
nixos/manual: rename "Configuration Syntax" section to "Options Management" [WIP] #57675
Motivation for this change
The current sections under Section II: Configuration of the NixOS Manual are as follows:
I propose changing the title of the "Configuration Syntax" section to "Options Management."
Although renaming the section involves some minor changes to its contents, this should make its contents much more easily discovered by new users of NixOS reading the Table of Contents.
In addition to better matching the contents of the section, it would allow for new sub-sections to be made in the future to further document the options management process, since the currently-named "Configuration Syntax" section is the best place in the manual to do so.
The reason for proposing this is #49899: better document
Most of the contents for a hypothetical "Accessing Option Values" section values is already written, found in [5.3 Modularity]. A dedicated section in the future would allow for further elaboration along with being more discoverable for readers who have not read the manual from start to finish (i.e. most, if not all, non-advanced users of NixOS, I assume).
Since this is a non-minor change, I assume that I will likely have to make some changes based on feedback, assuming this is eligible for being merged at all. Because of this, I marked the title with