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