Editing on this platform
This posting makes some comments about editing on this platform.
An overview of the discourse software that runs this platform can be found on this blog by one of the originators.
Unlike most discourse forums, this site does not utilize trust levels to slowly integrate new participants and allow them to acquire scope as they contribute. Rather than start at the default of TL0 (trust level zero), new users on this site are assigned TL2 from the outset. To compensate, applicants are instead screened as appropriate (as some will have experienced).
The platform uses a flavor of markdown to allow simple typesetting — that flavor is called CommonMark. Things to note:
- some help on the CommonMark syntax
- single and double linebreaks are significant: to flow your text in a paragraph, make sure no linebreaks are present
wikiposts are postings that can be edited by any registered user
- if you edit a wikipost, please leave a commit message if appropriate
Here are some advanced markup options:
- to add a contents listing to the top posting, utilize the following (requires the DiscoTOC component):
<div data-theme-toc="true"> </div>
<h2 id="heading--advanced-topics">Advanced topics</h2>
- to add a status line (officially an insert), add the following, with a rendered example below:
Referring to other users
If you wish to refer to another registered user, could you please use their
@username handle — which offers the following advantages:
- the user will be notified by email by default (although this behavior can be overridden)
- other users can click on the handle to reveal some background
- if the user asks to be erased, then discourse can automatically replace all mentions with a random string
Editing grace period
During the first 5 minutes after posting, editing will not create a new version in the post history. This is the default value and will probably apply on other discourse platforms too.
You can experiment using a sandboxed version of discourse offered by the development team and reset each day. You will need to sign up first using a valid email address. This discourse instance has no extra components installed (like discoTOC) and lacks the customizations found on this site. Your edits are also public for a while.
Custom emojis include
:closed_access: Also sometimes useful is
Suit yourself whether you edit in British english, American english, or some other language. If you edit in a non‑english language, could you add the appropriate tag to the topic.