jade

Insufficient links between guide and reference level docs makes splitting challenging

1

**Observations** Currently there are efforts to split docs into guide vs reference level materials and this is likely great but the reference level docs no longer are next to the...

Navigation doesn't keep track of your position in the hierarchy

1

**Observations** I click on concepts then flakes then "why should i enable flakes" from the home page. I open the sidebar on mobile. I expect to be able to navigate...

Link checker across nix documentation properties

4

**Observations** If we add more links, they might break. We can automate finding broken links between our things, in principle, and run it in ci. One difficulty is that the...

Version selector for Nix manual in title bar

2

**Observations** Currently the Nix docs as seen here don't have the version number switchable and don't raise that you're not looking at the latest: https://nix.dev/reference/nix-manual **Problem** It's hard to navigate...

Make a nixpkgs auto reply action for docs prs pointing to docs guidelines and specific contribution info

2

**Observations** Can be easy to put docs in the wrong place or in the wrong style for the place due to issues communicating our values for docs, and this has...

Inconsistent styling and lack of cross project navigation in Nix documentation

1

**Observations** https://nix.dev/reference/nix-manual and the nixpkgs and NixOS manuals and nix.dev don't have any navigation links between them or consistent styling. related discussion https://logs.nixos.dev/room/!avYyleMexqjFHoqrME:nixos.org/?anchor=$1a-p0jIFGfppHqFadSnQIpoX40mUALH9qt7griX9qWk&offset=-10 **Problem** The docs appear disjoint and not...

Split contribution docs into an isolated subsection and unify all Nix contribution docs into one site

2

**Observations** Currently nixpkgs, nix and the docs team have separate contribution information areas. Currently they use CONTRIBUTING files which can get long and don't necessarily have nice space for presenting...

Document connection strings for unix sockets with postgres

5

I am using `tmp-postgres` for Haskell which creates a Unix socket with a connection string like `host=/tmp/tmp-postgres-socket-33d7937af9c67679 dbname=postgres port=49905`. I want to use refinery-cli to apply my migrations to such...

I actually also don't know if this is even a reasonable request: such a function would be partial, since null does not exist in toml. ```dhall let Prelude = https://prelude.dhall-lang.org/package.dhall...

Context: I am working on a fork of something that is deliberately worktree'd with its diverged upstream to make cherry-picks faster, and I am using worktree-specific configs on this particular...