working on the dlang.org website

[Kapps]

On Wednesday, 14 August 2013 at 15:25:09 UTC, Flamaros wrote:
> I found a nice documentation website :
> http://docs.autodesk.com/FBX/2014/ENU/FBX-SDK-Documentation/index.html?url=cpp_ref/_common_2_common_8cxx-example.html,topicNumber=cpp_ref__common_2_common_8cxx_example_htmlc507b7ce-aa2f-4c44-b08f-90c94f43730b
>
> There is all sources of sample, and code is highlighted with 
> link to methods docs.
> I think it will be a good thing to have real unittest linked 
> with the documentation of D, just because instead embedded 
> samples we are sure that is executable as it (no missing 
> import, syntax error,...).
> It seems that is a bad idea to have specific code samples for 
> the documentation, it's generally out of date,... Is it 
> feasible to have docs that extract chunks of real unittest as 
> samples?

D has documented unit tests (Documented Unittests section at 
http://dlang.org/unittest.html) but they're a relatively new 
feature so most of the documentation doesn't yet use them.