<div dir="ltr"><div><div><div><div><div><div><div><div><div><div>Hey Christoph,<br><br></div>I was thinking about how the documentation should be built and I came up with the following proposal:<br><br></div>* Whenever you build CMake documentation in a module you get a piece of documentation covering<br></div>  the module itself and all its dependencies.<br></div><div>* Every module can add something to the Introduction part, by shipping a file doc/buildsystem/dune-foo.rst<br></div>* dune-common is the only core module, that builds a CMake doc during make doc (the other core modules<br></div>  do not add much value, so its basically redundant)<br></div>* The documentation for the webpage is generated from a module that depends on all core modules.<br></div>* The duneproject script should be changed to add a buildsystem doc in every user module, that collects<br></div>  the CMake API from all requirements, so users have a "personal" doc. (still TODO)<br><br></div>That is my idea, I am open to feedback here.<br><br></div>Dominic<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Oct 16, 2015 at 7:23 AM, Christoph Grüninger <span dir="ltr"><<a href="mailto:christoph.grueninger@iws.uni-stuttgart.de" target="_blank">christoph.grueninger@iws.uni-stuttgart.de</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Dominic,<br>
I just tried the Sphinx-based CMake documentation. It looks good so far<br>
for dune-common, thank you.<br>
With dune-grid and dune-istl Sphinx was not run as part of "make doc".<br>
What should I do? Or is this expected?<br>
<br>
Bye<br>
<span class="HOEnZb"><font color="#888888">Christoph<br>
<br>
--<br>
A mathematician is a scientist who can figure out anything, except<br>
such simple things as squaring the circle and trisecting an angle.<br>
[Evan Esar (1899-1995), Esar's Comic Dictionary]<br>
<br>
</font></span><br>_______________________________________________<br>
Dune-devel mailing list<br>
<a href="mailto:Dune-devel@dune-project.org">Dune-devel@dune-project.org</a><br>
<a href="http://lists.dune-project.org/mailman/listinfo/dune-devel" rel="noreferrer" target="_blank">http://lists.dune-project.org/mailman/listinfo/dune-devel</a><br>
<br></blockquote></div><br></div>