On Saturday, 24 February 2018 at 10:13:35 UTC, Paolo Invernizzi
wrote:
Have you tried to generate the documentation?
Look for example inside the source files...
https://github.com/pszturmaj/ddb/blob/bd55beea0df6e5da86a71535ff6d9800c0711c7c/source/ddb/postgres.d#L2
https://github.com/pszturmaj/ddb/blob/bd55beea0df6e5da86a71535ff6d9800c0711c7c/source/ddb/db.d#L19
I think no...
The documentation on how to use the package is present, it's
just inside the modules as Ddoc documentation.
Joe, you can easily 'extract' it using the proper -D compiler
switch
As I said, I'm new and still not familiar with those facilities
although I saw those things and they looked like embedded HTML
and was wondering what they were for.
Again, coming from Python, I'm familiar with RTD
(https://readthedocs.org, my own open source Python/Postgres
project is hosted there) and Sphinx
(http://www.sphinx-doc.org/en/master/). Although it started with
Python, RTD now hosts many other kinds of projects (Javascript,
PHP, Ruby, etc.). There's even a project named 'dlang' (it's not
what you expect!), but I did find "D Tips" and "Quick Start with
D" which appear to be standalone Markdown. In any case, it would
be nice to have such automatically generated docs available in a
public site/repo of some kind, like RTD, so a potential user
doesn't have to clone the code and run the compiler to see it.