<div dir="ltr"><div>Hi everyone, </div><div><br></div><div>Be sure to read the discussions on openstack-dev about scaling documentation efforts across projects. Lots of great discussion on this thread: <a href="http://lists.openstack.org/pipermail/openstack-dev/2014-October/047802.html">http://lists.openstack.org/pipermail/openstack-dev/2014-October/047802.html</a></div><div><br></div>We've got a new gerrit dashboard for doc reviews that shows works in progress as well as doc patches that have merged in the last week. Try it for yourself with <a href="http://is.gd/M4wghC">http://is.gd/M4wghC</a><div><br></div><div>This past week saw a lot of driver doc patches proposed and landing for storage and Hyper-V updates. We're happy to review those but I think we're carefully considering more pointers to outside documentation for driver configuration so that driver maintainers don't have to duplicate maintenance of docs. I'd love discussion on this point -- at the Ops meetup for example, they suggested just pointing to the external sites for those docs. Makes sense to me, but I want discussion.</div><div><br></div><div>In addition, the install guide work is ongoing. You can see the test matrix here: <a href="https://wiki.openstack.org/wiki/JunoDocTesting">https://wiki.openstack.org/wiki/JunoDocTesting</a> and note that testing is not yet started on release candidates. Feel free to test and fill in the matrix as you go. For the OpenStack dashboard (horizon) on Ubuntu, we're awaiting updates for a python-xstatic package dependency. </div><div><br></div><div>Also the networking guide has a small subteam working on it. The TOC for the networking guide is available at: <a href="https://wiki.openstack.org/wiki/NetworkingGuide/TOC">https://wiki.openstack.org/wiki/NetworkingGuide/TOC</a></div><div>So far we have three blog entries and some test results back from Phil Hopkins. We need more content for this guide so please do send it in with any format you have. </div><div><br></div><div>The Foundation has offered web designers to revise our (aging) <a href="http://docs.openstack.org">docs.openstack.org</a> site design and I met with them and Tom Fifield last week to go over the requirements and scope of the project. Looking forward to a refresh for sure. </div><div><br></div><div>For API documentation, I'm still working through a large change to remove the <a href="http://docs.openstack.org/api">docs.openstack.org/api</a> documents and point to the reference page at <a href="http://developer.openstack.org/api-ref.html">http://developer.openstack.org/api-ref.html</a>. In this change I need to propose patches for these projects specs repo:</div><div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><span style="font-size:12.7272720336914px">nova (compute-api) v2, v2.1</span><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">swift (object-api) v1</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">glance (image-api) v1, v1.1, v2</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">keystone (identity-api) v2.0, v3</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">neutron (netconn-api) v1.0, v2.0</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">cinder (volume-api) v1.0, v2.0</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">Then I can delete the repos in the parentheses above. </div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">Some projects don't have this type of document in a separate <service>-api repo that I know of, which is just fine:</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">trove</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><span style="font-size:12.7272720336914px">ceilometer</span><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">heat</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">sahara</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px"><span style="font-size:12.7272720336914px">ironic</span><br></div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">zaqar (marconi)</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">barbican</div><div style="font-family:arial,sans-serif;font-size:12.7272720336914px">designate</div></div><div>manila</div><div><br></div><div>I hope this cleanup can move us forward in API documentation questions of what docs, where to source and publish, and for whom do we write them. My current thinking is that there should be specs written for and by contributor devs, and also reference docs written for app devs by contributor devs and api writers.</div><div><br></div><div>This week I'm at the Grace Hopper conference with 7,999 other women in technology. Matt Kassawara has agreed to run the docs team meeting in #openstack-meeting tomorrow at 14:00 UTC (09:00 Central). Agenda is here: </div><div><a href="https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting">https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting</a><br></div><div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div><br></div><div><br></div><div><br></div></div>