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/zazgfoxjwhjbdrgdi...@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.
