#5984 - Deprecate tutorials; move to Wiki+ pages
0 guests and 0 members have recently viewed this.
The top 3 point earners from 7th Dec 2025 to 14th Dec 2025.
| PDStig |
|
|
|---|---|---|
| Gabri |
|
|
| Master Rat |
|
|
There are no events at this time
I am concerned about moving documentation off of the Comcode Pages because:
1) Then it can no longer be amended alongside Git contributions. E.g. if a new feature is added to galleries, the documentation cannot be updated alongside that, someone has to separately do that and if anyone wants to ensure quality they need to track that actually is happening (as opposed to it all going through one check point).
2) It will create a spam/quality problem that will take a lot of resources to fight.
3) Links will no longer be stable. For example, if someone decides to move key parts of a tutorial to another page, Composr linking to that tutorial will no longer be correct. Composr's code and the tutorials are tightly coupled.
Also merge requests *are* community contributions and GitLab lets you edit markdown pages inside its interface and create a Merge Request from it. We could lean into that, although we'd have to move to markdown (https://compo.sr/tracker/view.php?id=5842).
Perhaps the non-bundled addon can have special code where the Wiki+ reads in Comcode pages and uses that as the tree structure and page content for the tutorials. And the docs zone entry point would transparently redirect to those Wiki+ pages so that page links still work.
While I get merge requests are community contributions, those are geared towards developers. I'd like to make it easier for non-developers to write tutorials.