On Tue, Nov 22, 2022 at 10:54:47PM +0100, Dashamir Hoxha wrote:

Questa è una mailing list sotto moderazione dal board riservata alle comunicazioni per i membri del LugBZ. Siete pregati di NON condividerne il contenuto con persone terze.

Dies ist eine vom Board moderierte Mailing-Liste, welche für Mitteilungen an die LugBZ-Mitglieder vorgesehen ist. Bitte geben Sie ihren Inhalt NICHT an Dritte weiter.

========================================================

On Sat, Nov 19, 2022 at 7:17 PM Pasqualino Imbemba < pasqualino.imbemba@lugbz.org> wrote:

...

among our LugBz resources, do we have an internal wiki, where we can publish e.g. manuals/documentation of our services (mailing list, cloud space) etc.? The wiki should only be visible to members. If yes, would you please hint me towards it?

As a quick solution for documentation I would suggest using a private repo on GitLab, with markdown files. For example the mastodon docs are stored in markdown files: https://github.com/mastodon/documentation/tree/master/content/en/admin Maybe we can also use MkDocs (https://www.mkdocs.org/) which is still based on markdown files. If you don't like GitHub/GitLab, a nice self-hosted solution is Gitea ( https://gitea.io/), which is very easy to install.

I would recommend against using a wiki (for example mediawiki) for documentation purposes, because they often save the content in a database, not in plain text files. Text files (for example in markdown format) have the advantage of being able to store in a Git repo, with version control, pull-requests, etc.

Regards, Dashamir

Good point. Please take a look at this:

https://www.dewanahmed.com/markdown-asciidoc-restructuredtext/

I would prefer asciidoc though.