Notes
- PRs ready to merge?
- PRs for review:
-
@danielsidhion Creating a division in the nixpkgs manual for internal documentation
- Stuff like functions intended to be used only within nixpkgs (make-disk-image)
-
@infinisil: Grey zone, we want this to be rendered nicely, but it’s not public, we don’t have rendered internal docs right now
- Information on contributing packages written in specific languages in nixpkgs
- Sounds like a good fit for
.md
files within Nixpkgs
-
@danielsidhion: Would like to first have a rendered version of internal docs
- Adds clarity for people using nixpkgs stuff for their external stuff, and helps people understand nixpkgs-specific things to contribute to it
- But also works if we have an internal rendered version.
-
@infinisil: The Nixpkgs manual being for the stable user interface is a good distinction from internal/contributor docs, past agreement with docs team. But again, rendered version for internal docs would be great too.
- Relates to splitting the user manual into multiple pages, could use the same solution.
-
@infinisil: Reviewing @hsjobeki’s init support for doc-comments by hsjobeki · Pull Request #91 · nix-community/nixdoc · GitHub for RFC 145
5 Likes
Hosted by Flying Circus.