<div dir="ltr">Hi,<br><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Feb 25, 2014 at 10:01 PM, Szilárd Páll <span dir="ltr"><<a href="mailto:pall.szilard@gmail.com" target="_blank">pall.szilard@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">I could not find any<br>
documentation or reference to a required doxygen version on the wiki<br>
(there is nothing on doxygen on the wiki, it seems?).</blockquote><div><br></div><div>Up to quite recently, there was a separate page on the wiki on Doxygen. It had content that was more or less identical to the current <a href="http://jenkins.gromacs.org/job/Doxygen_Nightly_master/javadoc/html-lib/page_doxygen.xhtml">http://jenkins.gromacs.org/job/Doxygen_Nightly_master/javadoc/html-lib/page_doxygen.xhtml</a> (except somewhat outdated and had much less formatting or examples), but I removed it after the above got merged into master for a few different reasons:</div>
<div><ul><li>The information is very tightly tied to what is currently used in the source tree, so it is easiest to keep them in sync if both can be updated at the same time (and this also automatically takes care of the delay that code review brings).</li>
<li>Maintaining the text and making it easy to read was a pain in the wiki. With the current Markdown approach, it was actually possible to focus on the content and get the text and the examples ready in a lot shorter amount of time than it took to write the relatively messy wiki page. This is true even after considering that I had to fight with some weird Doxygen bugs or inconsistencies how it handled some things in Markdown.</li>
<li>During the time the information was on the wiki (a few years now), my impression was that it wasn't used that much, so I simply picked a location that is most convenient for me to maintain.</li><li>When the changes go through Gerrit, there is some finite chance to discuss things at that point, which the wiki approach didn't really accomplish: the wiki page and some related pages contained several questions that would need thinking about (some of them are also in Redmine issues), but I did not receive a single comment about any of those.</li>
<li>No one objected to removing the wiki page when the change was in review in Gerrit.</li></ul><div>The mentioned Jenkins-generated page is two clicks away from the wiki, starting from a link at the top of <a href="http://www.gromacs.org/Developer_Zone/Programming_Guide">http://www.gromacs.org/Developer_Zone/Programming_Guide</a><br>
</div></div><div><br></div><div>Best regards,</div><div>Teemu</div></div></div></div>