Ready to make page-per-item ddocs the default?

[Mathias LANG via Digitalmars-d]

On Wednesday, 7 January 2015 at 08:46:41 UTC, Vladimir Panteleev 
wrote:
> * Overzealous linking of words in the documentation that happen 
> to coincide with symbols in the same module. This should only 
> be done for text in $(D ...) tags.

According to the specs:
Identifiers in documentation comments that are function 
parameters or are names that are in scope at the associated 
declaration are emphasized in the output. This emphasis can take 
the form of italics, boldface, a hyperlink, etc. How it is 
emphasized depends on what it is - a function parameter, type, D 
keyword, etc. To prevent unintended emphasis of an identifier, it 
can be preceded by an underscore (_). The underscore will be 
stripped from the output.

So it's conforming. However, I think this specific part of the 
spec cause more problems than it solves. Just think about using 
`any`, `all`, `find` and so on in `std.algorithm.
Maybe it's time to update the specs ? :)