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

[Andrei Alexandrescu via Digitalmars-d]

On 1/7/15 12:46 AM, Vladimir Panteleev wrote:
> Remaining issues:
>
> * 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.

Yah, I'm quite unhappy about that, too.

> * Compile-time expressions are expanded to their computed variant. For
> example, `size_t.max` is expanded to `18446744073709551615LU`, which is
> not informative, and wrong on 32-bit systems. `Config.none` is now
> `cast(Config)0`, which sucks. I guess this is a compiler issue rather
> than a DDox one.

Hrm, not sure how easy it would be to fix this.

> More issues I noticed now from a quick look:
>
> * http://dlang.org/library/std/process.html :
>
>    The comparison table is gone, replaced with an unstructured blob of
> text.
>
> * http://dlang.org/library/std/parallelism.html :
>
>    More overzealous linking (e.g.: "These include _parallel_ foreach,
> _parallel_ reduce, _parallel_ eager map, ...").
>
> * http://dlang.org/library/core/time.html :
>
>    More overzealous linking - symbols within D string literals should
> not be linked.

Could you please fix or file these. Thanks!

> * I still have reservations about using Disqus.

I did keep that in mind. The long and short of it it it's impossible to 
make a change that everybody likes. We must move forward.


Andrei