<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Oct 2, 2014 at 4:58 PM, Stefano Maffulli <span dir="ltr"><<a href="mailto:stefano@openstack.org" target="_blank">stefano@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hello folks,<br>
<span class=""><br>
On Thu 02 Oct 2014 11:55:24 AM PDT, Anne Gentle wrote:<br>
> I'd like you to consider it a spec for cross-project since its<br>
> implementation should affect all project's developers.<br>
<br>
</span>From what I understand, what Vikram is suggesting would require a lot of<br>
people to agree on using doxygen as a standard to document APIs in code.<br>
Starting a blueprint would probably be the conclusion of a much larger<br>
conversation among all developers to get their buy-in first, otherwise I<br>
don't believe the blueprint will ever be approved.<br>
<br>
I would suggest to move the conversation to openstack-dev and check<br>
there the pulse for a switch to doxygen.<br></blockquote><div><br></div><div>Yep, that makes sense to me too.</div><div><br></div><div>I did a test run yesterday with Doxygen. Looking at the output, it seems we have the autodoc already with Sphinx, so you'll have to make a compelling case for a tools switch and all the infra work. Just letting you know that's my first cut analysis. I'm curious to know how you configure either tool to get more info out of the code. </div><div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
/stef<br>
<span class="HOEnZb"><font color="#888888"><br>
--<br>
Ask and answer questions on <a href="https://ask.openstack.org" target="_blank">https://ask.openstack.org</a><br>
</font></span></blockquote></div><br></div></div>