New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Document each store type on its own page #9504
Document each store type on its own page #9504
Conversation
# FIXME: this is a horrible hack to keep `nix help-stores` working. | ||
# the correct answer to this is to remove that command and replace it | ||
# by statically generated manpages or the output of something like `nix | ||
# store info <store type>`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
# store info <store type>`. | |
# store docs <store type>`. |
I'd say info
is for dumping info about instances of the noun rather than docs about the concept (or subtypes).
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think that's an intentional difference :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yeah, these are just ramblings.
filename = "${slug}.md"; | ||
page = showStore { inherit name slug; } storeInfo.${name}; | ||
}) | ||
(attrNames storeInfo); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
off-topic: We could get ourselves a lib
after implementing subtree fetching.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
From my phone, looks good modulo "slug" shadowing @roberth found.
829d3f5
to
e25cffe
Compare
This makes for more useful manual table of contents, that displays the information at a glance. The `nix help-stores` command is kept as-is, even though it will show up in the manual with the same information as these pages due to the way it is written as a "`--help`-style" command. Deciding what to do with that command is left for a later PR. This change also lists all store types at the top of the respective overview page. Co-authored-by: John Ericson <John.Ericson@Obsidian.Systems
e25cffe
to
78ed929
Compare
@Ericson2314 Review and rework of #8781
Motivation
This makes for more useful manual table of contents, that displays the
information at a glance.
Context
This change also lists all store types at the top of the respective overview page.
The
nix help-stores
command is kept as-is, even though it will show upin the manual with the same information as these pages due to the way it
is written as a "
--help
-style" command. Deciding what to do with thatcommand is left for a later PR.
This work is sponsored by Antithesis ✨
Priorities
Add 👍 to pull requests you find important.