Re: [Tcllib-devel] Tcllib - Dev- and other Guides - Looking For Feedback

[Andy G. <and...@gm...>]

On 4/9/19 10:46 PM, Andreas Kupries wrote:
> If you are tracking Tcllib's
> [timeline](https://core.tcl.tk/tcllib/timeline) you might have seen
> that I am currently working in a branch [1] on a full set of guides
> for the various roles (user, installer/builder, developer/maintainer,
> release manager) associated with Tcllib.

Cute, putting this email in markdown format.

> I am looking for feedback on things as simple as spelling and
> phrasing, up to higher-level discussion about maintainer commitments
> and the purpose of branches, how to work with them, etc.

The big issue I see is extraneous backslashes in verbatim code blocks,
those being lines of text that begin with at least four spaces.

Plenty of examples here:

https://core.tcl.tk/tcllib/doc/trunk/embedded/md/tcllib/files/modules/doctools/doctools_lang_syntax.md

Here is the source for the above:

https://core.tcl.tk/tcllib/artifact?fn=embedded/md/tcllib/files/modules/doctools/docidx_lang_intro.md&ci=trunk&txt=1

I'm not sure where to go to see any examples of this, but I am curious
of extraneous backslashes are also present within `...` code spans.

Here is the markdown rules reference:

https://core.tcl.tk/tcllib/md_rules

-- 
Andy Goth | <andrew.m.goth/at/gmail/dot/com>