Meetings/wiki/2024-07-05
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