Beginner's Guide for Topic Creation

Sooo great idea!

Discourse (our forum software) offers two three options I can think of:

  1. the general guidelines: https://community.openhab.org/guidelines
  2. the category “About”, e.g. About the Tutorials & Examples category
  3. the Topic Template

The first two can be modified by moderators, Topic Templates can (I don’t know why) only be modified by the Admin user (Kai).

Regarding the Topic Template: I need to warn everyone that anything added there is heavy weight. In the small text area in the bottom left you can’t see much and the fact that markdown is not interpreted doesn’t help. Look here for a bad example: https://central.owncloud.org/c/server/help

I believe the intention of @george.erhan is to add this content to “Setup, Configuration and Use”?

My suggestion would be to:

  1. In the Topic Template give a clean checklist of things a user should consider prior to posting. The whole template should span not more than 10-15 lines!
  2. Add all additional content, examples and instructions on “how to retrieve X” to the About Category article
  3. Update the guidelines if needed

The Guidelines and the About article should be the first point on the checklist.

Did I miss anything? What do you think?