Meetings/wiki/2024-07-05

From NixOS Wiki
Revision as of 11:58, 5 July 2024 by Lassulus (talk | contribs) (add meeting notes 2024-07-05)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Topics:

- Names of articles, Capitalization, Categories

- Relation of wiki to Manuals

- Layer09 Templates

- wiki link bot

Names of articles, Capitalization, Categories

- Titles of articles are capitalized in a different way now.

- discussion about style. should be: only beginning is capitalizeds, except if its a custom name (Home Assistant?)

- https://wiki.nixos.org/w/index.php?title=Manual_of_Style has a section about titles:

   - "Titles should be formatted in title case, capitalizing the first letter of each major word."

- Sönke will decide and change the manual of style accordingly

Relation of wiki to Manuals

- Valentin's opinion: everything should be in manual

   - wiki is staging grounds until it is moved to documentation

- Problems with that approach:

   - NixOS manual has wrong focus

   - wiki can be an approach to make that better

- Wiki can be used an entry points, sömke changed all the articles to reference the manuals

- valentins approach is not ideal, missing structure and the differentiation between reference manual and installation steps is not good in the manual

- Manual should be base install, should not document the installation of some web services, maybe drivers

- https://discourse.nixos.org/t/a-roadmap-for-the-documentation-ecosystem/42328/12

- idea would be to use the manuals as reference manuals and move guides to the wiki

- special services, like taskwarrior service should not be part of the nixos manual or activity pub servers

- manual should be: installation, desktop environments, maybe backups

- wiki should be: all other services/guides

- wiki should reference nixos manual where possible, maybe we can embed the manual text for specific services where possible:

   - it seems Cat had suggested a plugin there

   

- TL;DR: we try to make the wiki good, and we will reference upstream where possible and people can move stuff in either direction

Layer09 Templates

- https://wiki.nixos.org/wiki/User:SigmaSquadron/Template:Evaluate

- looks good

- https://wiki.nixos.org/wiki/Template:Editing_Template could also be edited, feedback from everyone welcome

wiki link bot

- bot was shadowbanned

- probably need to redo it with another account (and more players)

- we will continue on wednesday in the weekly jitsi meeting

Multilanguage

- we need an extension to support that

- Mic92 is investigating different plugins