Using flakes is not obvious, and no documentation has been written

[grahamc]

Figuring out how to use flakes has been a challenge, mostly reading commits and commit messages. I checked the docs looking for guidance, and didn't find any. I think a good way to go from here would be to write docs as changes happen, but we can talk more Monday.

For the eager readers:

nix build

seems to build (about half the time, anyway #84)

[CSVdB]

Thanks for the feedback!

Things I would like to write documentation about:

• What does a flake.nix look like?
• What is a flakeref?
• Explain new features of flakes:
  • Building is pure by default
  • Make a list of flakes-related commands and explain what they do (or what changed)
• Rewrite the original gist document
  Is there something else you would like to see explained? If so, let me know, or we can have a call about it!

[edolstra]

Also, existing parts of the manual will need to be rewritten from the legacy interface/mechanisms (nix-channel, nix-env, nix-build, nix-shell) to flakes. In particular, the "Quick start" chapter and Part III on "Package Management".

[stale]

I marked this as stale due to inactivity. → More info

[edolstra]

Closing, nix flake --help shows info on flakes now.