#5984 - Deprecate tutorials; move to Wiki+ pages
| Identifier | #5984 |
|---|---|
| Issue type | Feature request or suggestion |
| Title | Deprecate tutorials; move to Wiki+ pages |
| Status | Open |
| Tags |
Roadmap: Over the horizon (custom) |
| Handling member | Deleted |
| Addon | General / Uncategorised |
| Description | Deprecate / remove the tutorials addon and migrate all of the content into Wiki+ pages on composr.app .
Add re-directs for the docs zone to the new Wiki+ pages. |
| Steps to reproduce | |
| Additional information | The reason for this change is the community-centric focus of Composr CMS v11. I want to utilise the Wiki+ system from now on for tutorials so members can easily add their own content (via Wiki+ posts) to enhance the tutorials. |
| Funded? | No |
The system will post a comment when this issue is modified (e.g., status changes). To be notified of this, click "Enable comment notifications".


Comments
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.