nextcloud / collectives

Collectives is a Nextcloud App for activist and community projects to organize together.
GNU Affero General Public License v3.0
100 stars 18 forks source link

Migrate documentation to docs.nextcloud.com #399

Open mejo- opened 2 years ago

mejo- commented 2 years ago

In GitLab by @sunjam1 on Oct 3, 2022, 24:08

Hello, this is a request to port current documentation into the official docs.nextcloud.com where maintenance and improvements can continue.

Thank you for considering!

mejo- commented 2 years ago

In GitLab by @sunjam1 on Oct 6, 2022, 10:23

Is it difficult to convert your existing documentation to markdown? Wondering if you can "edit" your existing Gitlab pages and then simply copy-paste out the markdown so it can be edited externally.

I can always download the images shown on Gitlab and re-add them. Using the help forum is certainly an option for easy, wiki collaboration.

mejo- commented 2 years ago

Actually the documention is written in markdown: https://gitlab.com/collectivecloud/collectives/-/tree/main/docs

It gets built for Gitlab pages using hugo (a static site generator) using the Gitlab CI.

mejo- commented 2 years ago

In GitLab by @sunjam1 on Oct 6, 2022, 16:47

Okay, copy pasted source text from all three documents into the forum and added an index so browsing would be similar to how you have it on Github. Available for any user to edit as a wiki on help.nextcloud.com

mejo- commented 2 years ago

In GitLab by @max-nextcloud on Oct 12, 2022, 23:34

My understanding is that docs.nextcloud.com is currently based on restructured text rather than markdown and they want to keep it. However we will bring up the topic of also supporting markdown.