Discourse forum.gitlab.com - Add description templates for each category.
Problem to solve
We've noticed that folks sometimes avoid posting in a specific category because they have to fill out the template or post everything in Gneeral without considering categories.
Proposal
Create description templates for each category to help address this.
Generic text
- Link to the FAQ which explains how to format code blocks
- Encourage to use the category and tags -
#
can embed the names directly as clickable link.
Categories
All topic templates are persisted in the discourse-assets Git repository. https://gitlab.com/gitlab-da/projects/discourse-assets/-/tree/main/category_templates?ref_type=heads
Actions
-
Review existing topic templates for all categories, e.g. https://forum.gitlab.com/c/how-to-use-gitlab/edit/topic-template -
Create a proposed "generic" template with category variations -
Apply the changes -
Announce the changes in the community category for visibility
Results
- Every category on forum.gitlab.com provides a category which guides users in collecting question details about GitLab, Runner, DevSecOps, Duo, Observability -- or GitLab University, Community, and General questions.
- Templates in Git https://gitlab.com/gitlab-da/projects/discourse-assets/-/tree/main/category_templates?ref_type=heads
- Documentation MR: gitlab-com/content-sites/handbook!3834 (merged)
Edited by Michael Friedrich