-
-
Notifications
You must be signed in to change notification settings - Fork 266
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
implement the vision #701
implement the vision #701
Conversation
This pull request has been mentioned on NixOS Discourse. There might be relevant details there: https://discourse.nixos.org/t/2023-08-28-documentation-team-meeting-notes-76/32292/1 |
be71877
to
433a945
Compare
Fixed the redirects (I think); would really love to have #553 right about now |
433a945
to
da34749
Compare
Rebased over master. |
Shouldn't it work if you make a PR from a main repo branch and not a fork? |
Ah, maybe so! I don't use main repo branches. (If it does already work, we should close PR#479 and Issue#553) |
I suppose for everyone's sanity's sake we should break this change down and merge it piecemeal. Otherwise we will likely break things in unpleasant ways. |
This PR makes several decisions that I think each warrant their own discussions and PRs. Unless you want to endlessly rebase while we debate I suggest you follow @fricklerhandwerk's suggestion and make several smaller PRs. |
This pull request has been mentioned on NixOS Discourse. There might be relevant details there: https://discourse.nixos.org/t/2023-09-31-documentation-team-meeting-notes-77/32497/1 |
This pull request has been mentioned on NixOS Discourse. There might be relevant details there: https://discourse.nixos.org/t/learning-journey-working-group-2023-08-31-meeting-notes-23/32498/1 |
This pull request has been mentioned on NixOS Discourse. There might be relevant details there: https://discourse.nixos.org/t/2023-10-05-documentation-team-meeting-notes-84/33877/1 |
This pull request has been mentioned on NixOS Discourse. There might be relevant details there: https://discourse.nixos.org/t/this-month-in-nix-docs-5-september-2023/33856/7 |
da34749
to
98c296d
Compare
Co-authored-by: Valentin Gagarin <[email protected]>
98c296d
to
09af941
Compare
This does not yet follow NixOS#701, because the change to get there would be too big. The goal is to keep the table of contents meaningful at all times and the diff of each pull request manageable. The packaging tutorial is quite important, so it's not wrong to have it visible on the front page until we have enough material for a packaging section. The sharing dependencies article should really be a very brief guide, but because that would be quite a big change, I moved it to tutorials section for now even if the order doesn't make much sense.
This does not yet follow NixOS#701, because the change to get there would be too big. The goal is to keep the table of contents meaningful at all times and the diff of each pull request manageable. The packaging tutorial is quite important, so it's not wrong to have it visible on the front page until we have enough material for a packaging section. The sharing dependencies article should really be a very brief guide, but because that would be quite a big change, it's only moved to the Guides section for now.
This does not yet follow NixOS#701, because the change to get there would be too big. The goal is to keep the table of contents meaningful at all times and the diff of each pull request manageable. The packaging tutorial is quite important, so it's not wrong to have it visible on the front page until we have enough material for a packaging section. The sharing dependencies article should really be a very brief guide, but because that would be quite a big change, it's only moved to the Guides section for now.
This does not yet follow NixOS#701, because the change to get there would be too big. The goal is to keep the table of contents meaningful at all times and the diff of each pull request manageable. The packaging tutorial is quite important, so it's not wrong to have it visible on the front page until we have enough material for a packaging section. The sharing dependencies article should really be a very brief guide, but because that would be quite a big change, it's only moved to the Guides section for now.
I tried to compile all the insights we gleaned from this experiment in #572. Closing this as a signal that it's now the time to write more tutorials. |
This PR implements the grand vision here
Just moved some stuff around
Done with ❤️ in the Docs Team Meeting with @fricklerhandwerk @alejandrosame