[ET Trac] [Einstein Toolkit] #1038: remove compiled documentation from Cactus repository
Einstein Toolkit
trac-noreply at einsteintoolkit.org
Mon Aug 13 11:37:32 CDT 2012
#1038: remove compiled documentation from Cactus repository
--------------------------+-------------------------------------------------
Reporter: rhaas | Owner:
Type: enhancement | Status: new
Priority: optional | Milestone:
Component: Cactus | Version:
Resolution: | Keywords: documentation
--------------------------+-------------------------------------------------
Comment (by eschnett):
LaTeX is not installed by default e.g. on Mac OSX, or maybe on some
supercomputers where people may be trying their first steps.
Also, the question is not whether people can build the documentation, the
question is how easy we can make it for people to begin reading the
documentation.
All the arguments above argue that it is too much work for maintainers to
ensure to rebuild the documentation after changing it, or handling
documentation conflicts. I don't buy either of this; everybody making
changes to the documentation will run latex anyway, and svn will then
automatically suggest committing the new pdf. Having to handle conflicts
in the pdf files is also very rare, and is very easy (same as above,
everybody will run latex anyway just to check whether the merged latex
sources still work).
--
Ticket URL: <https://trac.einsteintoolkit.org/ticket/1038#comment:10>
Einstein Toolkit <http://einsteintoolkit.org>
The Einstein Toolkit
More information about the Trac
mailing list