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

Vladimir Panteleev via Digitalmars-d digitalmars-d at puremagic.com
Wed Jan 7 00:46:40 PST 2015


On Tuesday, 6 January 2015 at 22:43:45 UTC, Andrei Alexandrescu 
wrote:
> Let's crowdsource the review. Please check the entries linked 
> from here: http://dlang.org/library/index.html.

 From my last complain thread:

http://forum.dlang.org/post/zazgfoxjwhjbdrgdiiqv@forum.dlang.org

I see that many of the issues with my example got fixed.

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.

* 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.

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.

* I still have reservations about using Disqus.


More information about the Digitalmars-d mailing list