NixOS Wiki:Contributing: Difference between revisions

From NixOS Wiki
Klinger (talk | contribs)
→‎Style: this part is in MoS now.
Klinger (talk | contribs)
m all relevant content moved to other articles
Tag: New redirect
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
This article is a guide to contributing to the Wiki. Contributors are encouraged to write new articles or modify existing ones as they see fit, but it is appreciated and encouraged to follow the recommendations of this guide as for as possible whenever they are applicable.
#Redirect [[Contributing]]
 
== Spirit of the Wiki ==
 
The NixOS Wiki is a ''user community'' effort, meant to be complementary to the [https://nixos.org/manual/nixos/stable/ NixOS  reference manual] rather than a replacement for it. The following properties distinguish the spirit of the Wiki from reference documentation:
; Ecosystemic: The manuals cover the interfaces and mechanisms of specific components (Nix, Nixpkgs, NixOS, etc.) while the Wiki covers the Nix ecosystem as a whole and focuses on NixOS as a point of integration.
; Heterogeneous: The reference manuals merely present all interfaces factually. The Wiki has the potential to reveal the more diverse or opinionated approaches and workflows used in practice.
; Pragmatic: The reference manuals are intended for comprehensive and detailed reference, while the Wiki emphasizes practical resources such as guides, examples, and troubleshooting tips.
; User community: The reference manuals cover mechanisms and inner workings, which are mainly important for developers and contributors. The Wiki is oriented around the broad spectrum of real-world use cases.
 
== Finding stuff to do ==
 
The following are ways to find out (or let people know) what needs to be done:
* Use the [https://github.com/NixOS/nixos-wiki-infra/projects Wiki Projects] page to list or join a project and the [https://github.com/NixOS/nixos-wiki-infra/issues Wiki Issues] page to raise issues and find stuff to do.
* Help improve flagged articles in the appropriate way.
* Flag articles if you find something missing, incorrect or out-of-date using [[Help:Template|templates]].
* Update [[Special:WhatLinksHere/Template:Outdated|outdated articles]].
* Fill out [[Special:WantedPages|missing articles]], and missing sections in any article.
* Write [[:Category:Tutorial|tutorials]] and [[:Category:Guide|guides]] to help ease pain-points for beginners.
 
== Who Can Contribute? ==
 
The NixOS wiki is open for anyone with an account to contribute in the ways listed above. However, wiki moderators have the final say on what can or cannot be on the wiki. For any questions or concerns, the moderation can be contacted through the [https://matrix.to/#/#wiki:nixos.org NixOS wiki matrix room].
 
=== Workgroups ===
Workgroups are interest groups of people working on the same topic in the nix* ecosystem.
* [[Workgroup]]s (“Interest Groups”)
** [[Workgroup:Container]]
** [[Workgroup:Router]]
** [[Workgroup:DataScience]]
 
== Tagging articles ==
 
The MediaWiki provides a way to tag articles (at the end of the article). We are using this feature to structure the Wiki.
 
=== Ecosystem tags ===
 
Elements of the Nix Ecosystem should be tagged by one or more of the following categories:
; <code>[[:Category:NixOS|<nowiki>[[Category:NixOS]]</nowiki>]]</code>: Articles related to the Nix operating system, the module system and the system configuration.
; <code>[[:Category:Nix|<nowiki>[[Category:Nix]]</nowiki>]]</code>: Articles about using the Nix Tools to accomplish great things.
; <code>[[:Category:Nixpkgs|<nowiki>[[Category:Nixpkgs]]</nowiki>]]</code>: Articles about maintaining code in the Nixpkgs repository, structuring, and so on.
; <code>[[:Category:Nix Language|<nowiki>[[Category:Nix Language]]</nowiki>]]</code>: Description of language quirks and solutions.
; <code>[[:Category:Hydra|<nowiki>[[Category:Hydra]]</nowiki>]]</code>: Articles about Hydra continuous Integration related documentation.
; <code>[[:Category:Application|<nowiki>[[Category:Application]]</nowiki>]]</code>: Extended Ecosystem: Articles about other Nix-based or Nix-related applications.
 
=== Topic tags ===
Almost all content of the wiki can be accessed with 2 to 3 clicks via one of these topic categories:
; <code>[[:Category:Software|<nowiki>[[Category:Software]]</nowiki>]]</code>: Articles about software applications like neovim or libreoffice
; <code>[[:Category:Hardware|<nowiki>[[Category:Hardware]]</nowiki>]]</code>: Articles about hardware like GPU, keyboards and notebooks.
; <code>[[:Category:Desktop|<nowiki>[[Category:Desktop]]</nowiki>]]</code>: Articles about using NixOS on a PC (e.g. desktop environments)
; <code>[[:Category:Server|<nowiki>[[Category:Server]]</nowiki>]]</code>: Articles about using NixOS on servers, like running web applications (e.g. Nextcloud)
; <code>[[:Category:Community|<nowiki>[[Category:Community]]</nowiki>]]</code>: Articles about the Nix(OS) community and how to engage and contribute.
 
=== Resource tags ===
 
The [https://www.divio.com/en/blog/documentation/ type of documentation] for new pages should be tagged with one of the following categories:
; <code>[[:Category:Tutorial|<nowiki>[[Category:Tutorial]]</nowiki>]]</code>:
:* is learning-oriented
:* allows the newcomer to get started
:* is a lesson
; <code>[[:Category:Discussion|<nowiki>[[Category:Discussion]]</nowiki>]]</code>:
:* is understanding-oriented
:* explains
:* provides background and context
; <code>[[:Category:Guide|<nowiki>[[Category:Guide]]</nowiki>]]</code>:
:* is goal-oriented
:* how-to's for dealing with a specific problem / tool
:* is a series of steps
; <code>[[:Category:Cookbook|<nowiki>[[Category:Cookbook]]</nowiki>]]</code>:
:* is recipe orientated
:* a collection of short code snippets and hacks
:* arranged around a theme or tool
; <code>[[:Category:Reference|<nowiki>[[Category:Reference]]</nowiki>]]</code>:
:* is information-oriented
:* describes the machinery
:* is accurate and complete
:* Most of the time the NixOS Wiki will not contain reference documents
 
== References ==
 
* [https://www.divio.com/en/blog/documentation/ Types of Documentation]
* [https://github.com/nixos-users/wiki/issues/3 Wiki Restructuring Discussion]
 
[[Category:Guide]]
[[Category:Community]]

Latest revision as of 19:52, 2 September 2024

Redirect to: