New (page-per-artifact) standard library doc examples are now editable and runnable

Seb via Digitalmars-d-announce digitalmars-d-announce at puremagic.com
Mon Feb 27 09:13:24 PST 2017


On Monday, 27 February 2017 at 16:49:13 UTC, David Nadlinger 
wrote:
> On Monday, 27 February 2017 at 15:41:18 UTC, Seb wrote:
>>> Is it redditable?
>>
>> Yes, finally :)
>
> Can we fix the fact that the docs are duplicated for template 
> functions before any big announcements? See e.g. 
> https://dlang.org/library-prerelease/std/algorithm/comparison/among.html from above.

That's one of the disadvantages of running two documentation 
engines.

Related pointers:

https://github.com/dlang/dlang.org/pull/1526 (making ddox the 
default)
https://github.com/rejectedsoftware/ddox/issues

>  This leaves quite the bad impression, as it makes the page 
> look like an unstructured mess at first glance.

A solution for the moment is to point people at the ddoc version, 
e.g.

https://dlang.org/phobos/std_algorithm_comparison.html#.among


More information about the Digitalmars-d-announce mailing list