code.dlang.org packages' docs

Luís Marques via Digitalmars-d digitalmars-d at puremagic.com
Tue May 24 08:26:31 PDT 2016


Hi,

code.dlang.org could be improved with regards to the 
documentation of the packages it lists.

As low hanging fruit, I suggest that the package information 
table (version, home page, repo, license, etc.) be extended with 
the documentation URL of the respective package, instead of it 
being an ad hoc part of the Readme section, and often missing.

More generally, I would suggest that code.dlang.org also served 
as a centralized repository of the documentation of each package. 
For instance, the package serial-port 
(<http://code.dlang.org/packages/serial-port>) links to 
<http://ncrashed.github.io/serial-port/index.html>. This is 
another site, with a different visual style and doc generator 
layout, another possible point of failure, etc. I realize it 
might be challenging to generate and host all the docs at 
code.dlang.org, but I feel it would create a more "professional", 
unified and pleasant experience.


More information about the Digitalmars-d mailing list