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 |
proofconstruction
force-pushed
the
rebased-index
branch
from
be71877
to
433a945
Compare
|
Fixed the redirects (I think); would really love to have #553 right about now |
proofconstruction
force-pushed
the
rebased-index
branch
from
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 |
fricklerhandwerk
force-pushed
the
rebased-index
branch
from
da34749
to
98c296d
Compare
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
fricklerhandwerk
force-pushed
the
rebased-index
branch
from
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