Zero to Nix, an unofficial, opinionated, gentle introduction to Nix

Re:Zero to Nix, an unofficial, opinionated, gentle introduct... by JamesSwift on Monday January 23, 2023 @12:32PM (#34492018)

If thats the intent, then it seems the Quick Start is what I'd adjust to be more linear then : )

Again, it looks like a basket of equally-weighted links that a user is free to click into at leisure. It seems more like a directory of useful links rather than a "highly opinionated" guide to get me from zero to proficient.

Compared to something like the sveltekit docs [1] (randomly pulled because I was viewing it today) its much easier to understand the flow of topics, and I think a user can assume they should read them in the presented order unless they understand a given topic already.

[1] - https://kit.svelte.dev/docs/introduction

[ Parent | on HN ]

Re:Zero to Nix, an unofficial, opinionated, gentle introduct... by JamesSwift on Monday January 23, 2023 @12:34PM (#34492057)

Actually I just realized I was confused because of the homepage styling. On the homepage it has the "quick start" pill in an active state, which I thought meant I was already _on_ the quick start page. It turns out you click that to actually view page 1 of the quick start. But on that page the "linear list of topics" is only shown when clicking the quick start in the header nav. I would add that to the sidebar by default.

[ Parent | on HN ]

Re:Zero to Nix, an unofficial, opinionated, gentle introduct... by monocularvision on Monday January 23, 2023 @12:36PM (#34492082)

Yeah “Quick Start” is really a misleading title for this “section” as it is really the meat of the site itself.

[ Parent | on HN ]