search

samoht / assemblage

A collection of tools to manage the configuration of OCaml projects
54 stars 4 forks source link

Doc generation #16

Closed dbuenzli closed 10 years ago

dbuenzli commented 10 years ago

Is it a good idea to generate documentation directly in the doc directory ? For sure I eventually want it there when I do a tarball, but I think that before making a release assemblage should stick to its build dir.

dbuenzli commented 10 years ago

Also doc generation seems to be completely implicit. In some of my projects I do have two documentation sets: one for the API, that I distribute with the project and one for the package development itself which is API + internal interfaces and that I only generate to be able to work on the project. Example, tgls (api, dev-api).