dub
dub copied to clipboard
add docs command
Should become the new subcommand for document generation, the current -b docs and -b ddox methods are hardly configurable.
http://forum.dlang.org/thread/[email protected]#post-tcunkoqxnzcsjzfajjvn:40forum.dlang.org
+1 The post is a bit old, the unittest-by default is long-fixed.
What should 'docs' be able to do ? One of the killer feature I'd like to see in is the ability to integrate directly with Github (see: #355 & #449 )
The lack of configurability is a real pain at the moment
You should mention in the documentation that the existing -b docs is recursive "dumb". I was irritated (several hours long) when i only wanted to generate documentation for my own project.
Desperate ping. I need to build docs for my project only, not dependencies.
You could add this issue to the DUB User experience story here (https://github.com/dlang/projects/issues/1) and I recommend voting for it (via GitHub reactions).
My current workaround for this:
- build using dub -b ddox to get the docs.json file properly generated.
- ~~remove docs directory~~ Can't do this actually, because dub build -b ddox copies some css and other stuff that the main ddox command does not (rsync the public stuff)
- run ddox directly with command line I want.
It would be great to be able to configure the doc generation.