[OpenStack-docs] Autogenerate the API Reference

Jeremy Stanley fungi at yuggoth.org
Fri May 8 13:43:05 UTC 2015


On 2015-05-08 08:06:23 -0500 (-0500), Anne Gentle wrote:
> Right, but the counterpoint is that docs are supposed to document
> final state and truth, and by scraping during a non-final dev time
> period, the docs won't themselves be stable. So that's where the
> difficulty lies. :)

Much like we have a string freeze for the benefit of translators and
a requirements freeze for the benefit of package maintainers,
perhaps we need an API freeze for the benefit of documentation
authors (or in this case those wrangling the scrapers at least).
-- 
Jeremy Stanley



More information about the OpenStack-docs mailing list