Skip to content
This repository has been archived by the owner on May 9, 2024. It is now read-only.

[question] Where to raise questions when it comes to content organization? #43

Open
toraritte opened this issue Aug 2, 2022 · 4 comments

Comments

@toraritte
Copy link

I wholeheartedly agree with @samueldr that "content for the wiki should be authored on the wiki", but was wondering where questions regarding content organization can be asked? The "Discussion" button/subpage seem to be for this purpose for each page, but I have no clue who would see these notes unless one explicitly click on the button.

For example, I was pondering why the Module article is not titled "NixOS module"? Even though it is in the NixOS category, the category list only shows up at the bottom of the page and someone with little Nix* expertise may not know that neither Nix nor Nixpkgs has modules (right?..). The intro is perfectly clear that this article describes modules in the context of NixOS, but the Nixpkgs manual uses the term "module" in at least a dozen different contexts - except when referring to the NixOS modules.

Before renaming though, I wanted to do my due diligence so I checked "Discussions", nothing there, so I checked what pages are linked to it. Found the following:

Now, I was able to find the entry for the latest name change in the history,

(cur | prev) 16:07, 9 June 2019Mth (talk | contribs)‎ m . . (7,613 bytes) (0)‎ . . (Mth moved page NixOS Modules to Module) (undo)

but there is no rationale for this action. My reasoning may be entirely flawed, so it would be nice to discuss it (and avoid changing the title back and forth).

@fricklerhandwerk
Copy link

where questions regarding content organization can be asked

It's a good question, and we should answer it prominently in multiple locations:

  • on NixOS Wiki itself
  • in this repository
  • in the documentation team contribution guidelines

who would see these notes

Anyone who follows the NixOS Wiki Matrix room, which should at least be the Nix documentation team.

why the Module article is not titled "NixOS module"

Thanks for the considerations, I fully agree with your assessment. I'd say just rename it to "NixOS module". Link to this discussion in the changelog to prevent the same situation of missing rationale for future rounds of questions.

neither Nix nor Nixpkgs has modules (right?..)

Exactly.

@toraritte
Copy link
Author

toraritte commented Aug 3, 2022

Thanks! Adding tasks for self:

  • rename "Module" page to "NixOS modules"
  • Document where to raise questions
    • [_] on NixOS Wiki itself
    • [_] in this repository
    • [_] in the documentation team contribution guidelines

@nixos-discourse
Copy link

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/summer-of-nix-documentation-stream/20351/4

@nixos-discourse
Copy link

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/summer-of-nix-documentation-stream/20351/2

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants