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