Isn't there an actual FAQ for the board software?

There are a series of interactive tutorials users have the option to complete via DMs with the bot here, that teach most of the basic and intermediate concepts. The meta.discourse.org site has a bunch of information, such as e.g. the Discourse New User Guide. And its own FAQ offers more high-level advice, something closer to what ours probably should.

I definitely agree we should change this, along the lines of the proposals iterated on the ChatGPT thread, e.g. @Quercus 's. It doesn’t seem to make any sense to have the entire content of the “FAQ” be just a copy/paste of the PSF CoC, which could instead be prominently linked at the top and in a FAQ answer. It just seems like there hasn’t yet been enough critical mass of consensus to take action on it yet.

TIL; I didn’t know (or maybe I forgot) that syntax was supported and thought only worked with the inline syntax instead, since the inline form is actually what is displayed to users. [1]

Ideally, Discourse would display these as normal footnotes, and inline Markdown footnotes as the current inline footnotes, to match the syntax to the visual presentation—it’s rather strange to use the “numbered” syntax for inline footnotes, and vice versa. This is something you brought up before, among other issues with the current inline-only footnotes, and in hindsight (despite arguing otherwise at the time) I think you’re right—though the presentation matching the syntax would really be the best of both worlds.


  1. And indeed, it seems it does. ↩︎

1 Like