Jump to content

Talk:Manual of Style

From NixOS Wiki

Suggestion: Remove nonsensical warning about copyright violations from style manual

How is the following section a reflection on style?

Contribution recommendation: It is recommended that editors only contribute to one wiki at a time to ensure they do not inadvertently violate the copyright policies of the wikis they edit.

And what copyright policies might be violated? The official NixOS wiki is already a copy of the unofficial NixOS wiki which is licensed under MIT, and the official NixOS wiki is also licensed under MIT. So I can't see what copyright policies are being violated that weren't violated in the creation of the wiki. -- Sshine (talk) 20:51, 6 March 2025 (UTC)Reply

Interesting, maybe we can decide to delete this sentence in the next wiki-meeting or exchange it with something like "It is recommended that editors only contribute to one wiki at a time to avoid accidentally violating style guides and structuring." Klinger (talk) 18:12, 11 March 2025 (UTC)Reply
It seems like the opinion is that one should not contribute to both wikis, and the reasoning can be applied and modified later, which suggests to me that either the incentive is either not rational, or not directly honest. If I am to speculate, I believe that the desire is to let the unofficial wiki gradually deprecate into oblivion, so that it can be declared dead. And if we can encourage or incentivize that to happen sooner rather than later, that is a good thing. I believe this is based on wishful thinking and not an actual assessment of the negative impact on the availability of Nix documentation to the wider ecosystem. Sshine (talk) 14:06, 11 May 2025 (UTC)Reply

[...] the desire is to let the unofficial wiki gradually deprecate into oblivion [...]

Yes, the goal is exactly that. We want one single wiki to be the source of information for NixOS, and we need it to be under the control of the NixOS community. It doesn't do the community any favours if search engines show two identical-at-a-glance options for documentation. Before people notice that the unofficial wiki is extremely outdated, missing pages, and managed by people who think that "NixOS Woke Invasion" is an acceptable title to have in one of their articles, they'll add missing options to their configurations, or follow some deprecated, out-of-tree guide.
A positive thing for the ecosystem would be if that Wiki finally accepted that their time is past, and redirected to this truly community-managed Wiki. If they want to keep their nonsense like the article mentioned by name above, then they can host a website under some other domain that doesn't seem like an official NixOS domain.

People should not be contributing to a dying platform. SigmaSquadron (talk) 21:51, 12 May 2025 (UTC)Reply

Add guidelines for common Infoboxes

There are a couple of common infoboxes used on wiki pages.

We could also bootstrap a new infobox for nixos-version-specific infos (that could be discarded once the nixos version becomes very old). Pogobanane (talk) 08:10, 26 October 2024 (UTC)Reply

Actually this goes into Help:Template Pogobanane (talk) 08:21, 26 October 2024 (UTC)Reply
Resolved: Linked Help:Template in this Manual of Style. Pogobanane (talk) 08:28, 26 October 2024 (UTC)Reply

Suggestion: Add a small section directing editors to use the Template:Cleanup template

I made this template because some pages (like ALSA) were using the Outdated template to mark a section that needs reformatting. This template also links directly to the MoS for ease of access.

Thus, I wanted to check if it'd be okay to edit the MoS to specify that this template can be used if an editor notices a page that "breaks" the style. DoggoBit (talk) 16:30, 5 June 2025 (UTC)Reply

I am all for this. Layer-09 (talk) 10:10, 6 June 2025 (UTC)Reply

Proposal: Split off Help:Syntax out of Manual of Style

There are a few sections (linking, lists, etc.) which could be significantly more useful as a Help:Syntax reference page. Similar to how templates are expanded upon in Help:Templates, keeping things short in the MoS. I suggest we do the same here DoggoBit (talk) 23:48, 7 June 2025 (UTC)Reply

Proposal: Rename Manual of Style to NixOS Wiki:Manual of Style

In general, the common pattern across wikis is to keep internal policy documents and project-wide efforts in the Project: special namespace (which in our case is NixOS Wiki:). Another use for this namespace are copyright policies, user conducts, etc., as well as wikiprojects (wiki-wide efforts around a common theme; e.g.: NixOS Wiki:Popular boards)

P.S. Additionally we could configure a shorthand namespace as well (e.g.: NIX:MOS). DoggoBit (talk) 23:52, 7 June 2025 (UTC)Reply