Time to have standard style to write help documentation?

In a related thread:

This is why I linked to the GH Issues above - that was the approached used to facilitate hashing out details in the previous effort to develop formatting guidelines. There was a “point person” that moved the discussion along, and made a judgement call when there had been enough discussion and decided if there was consensus.

There could be other approaches, coordinated in an RFC, for example. I don’t think this thread is the place to decide each case (I’m glad though that @prko has already introduced some very good cases that resonate with many people, I’m sure!).

I have personally kept track of a couple dozen+ suggestions or open questions related to scdoc formatting, but I never shared them because I wasn’t in a place to coordinate the effort. So I’d be happy to chime in with those if a project gets off the ground :slight_smile:

3 Likes