namespace urls do not NEED to resolve.  <br><br>but, they can.  and that would be nice for 2 reasons I can think of.<br><br>1.  when you google for docs on an api method without a real documentation url those links show up and 404.  That is annoying.  Also if they do resolve, the namespace url suddenly picks up a second use.  Which is pretty nice.<br>
<br>2.  the namespace urls are used to map in namespace all the api methods.  which means it's something of an authoritative source of api calls.  This means you can gate test for documentation, or simply get quick stats on how many methods are undocumented.  <br>
<br>that's my thinking anyways.<br><br>-Matt<br><br><div class="gmail_quote">On Thu, Oct 11, 2012 at 8:33 PM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div bgcolor="#FFFFFF"><div>Hi all -</div><div><br>I'm doing some legwork on how feasible and how much work this is - don't have an informed opinion yet. I was always told that the namespace is just a string and does not need to resolve for each method.</div>
<div><br></div><div>Anne</div><div><div class="h5"><div><br>On Oct 9, 2012, at 3:14 PM, Matt Joyce <<a href="mailto:matt.joyce@cloudscaling.com" target="_blank">matt.joyce@cloudscaling.com</a>> wrote:<br><br></div><div>
</div><blockquote type="cite"><div><a href="https://bugs.launchpad.net/openstack-manuals/+bug/1064645" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bug/1064645</a><br><br>Filed this bug for the documentation.<br>
<br>Is anyone opposed to the idea of making existence of corresponding method documentation a condition of namespace test cases in CI?<br>
<br>-Matt<br>
</div></blockquote></div></div><blockquote type="cite"><div><span>_______________________________________________</span><br><span>OpenStack-dev mailing list</span><br><span><a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a></span><br>
<span><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a></span><br></div></blockquote></div><br>_______________________________________________<br>

OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br></blockquote></div><br>