Inline code in the docs - the correct way
Steven Schveighoffer
schveiguy at yahoo.com
Thu Feb 1 01:37:58 UTC 2018
On 1/31/18 5:55 PM, Adam D. Ruppe wrote:
> Now though, inline code like $(D) and $(REF) are ambiguous. They are
> short enough that they'd normally fall into my "ok with it" zone like
> $(B)... but they are also so common and I want to encourage their use.
> And having three shifted characters that must appear in order is kinda
> painful to type - it just breaks up the thought process, and can get
> somewhat weird to look at.
Where it breaks down is when you have many nested tags, and you end with
)))))
I hate that. I've seen many bugs in the D documentation because of that.
I'd rather we use different delimeters for different tags, like markdown.
-Steve
More information about the Digitalmars-d
mailing list