Hi Lana, Thanks for the summary, it's pretty good reading to catch up what happened recently.
I have one question, I might missed a few entries, so please point me to the right document in this case. We had a docco session with the Telemetry team and we agreed on moving back the documentation snippets, like for instance the Install Guide, to the project trees is a really good step and we're very supportive. In this sense I would like to ask about the plans regarding the Admin guide. We have a chapter there, which is on one hand outdated and on the other hand would be better to move under the project trees as well. Is this plan/desire in line with your plans regarding that document? Thanks, /Ildikó > -----Original Message----- > From: Lana Brindley [mailto:openst...@lanabrindley.com] > Sent: May 06, 2016 08:13 > To: enstack.org; OpenStack Development Mailing List; > openstack-i...@lists.openstack.org > Subject: What's Up, Doc? 6 May 2016 > > Hi everyone, > > I hope you all had a safe journey home from Summit, and are now fully > recovered from all the excitement (and jetlag)! I'm really > pleased with the amount of progress we made this time around. We have a > definitive set of goals for Newton, and I'm confident that > they're all moving us towards a much better docs suite overall. Of course, > the biggest and most important work we have to do is to get > our Install Guide changes underway. I'm very excited to see the new method > for documenting OpenStack installation, and can't wait > to see all our big tent projects contributing to docs in such a meaningful > way. Thank you to everyone (in the room and online) who > contributed to the Install Guide discussion, and helped us move forward on > this important project. > > In other news, I've written a wrapup of the Austin design summit on my blog, > which you might be interested in: > http://lanabrindley.com/2016/05/05/openstack-newton-summit-docs-wrapup/ > > == Progress towards Newton == > > 152 days to go! > > Bugs closed so far: 61 > > Because we have such a specific set of deliverables carved out for Newton, > I've made them their own wiki page: > https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables > Feel free to add more detail and cross things off as they are achieved > throughout the release. I will also do my best to ensure it's kept > up to date for each newsletter. > > One of the first tasks we've started work on after Summit is moving the Ops > and HA Guides out of their own repositories and into > openstack-manuals. As a result, those repositories are now frozen, and any > work you want to do on those books should be in > openstack-manuals. > > We are almost ready to publish the new RST version of the Ops Guide, there's > just a few cleanup edits going in now, so make sure you > have the right book, in the right repo from now on. This was our very last > book remaining in DocBook XML, so the docs toolchain will > be removing DocBook XML support. See spec https://review.openstack.org/311698 > for details. > > Another migration note is that the API reference content is moving from > api-site to project specific repositories and api-site is now > frozen. For more detail, see Anne's email: > http://lists.openstack.org/pipermail/openstack-docs/2016-May/008536.html > > == Mitaka wrapup == > > We performed a Mitaka retrospective at Summit, notes are here: > https://etherpad.openstack.org/p/austin-docs-mitakaretro > > In particular, I'd like to call out our hard working tools team Andreas and > Christian, all our Speciality Team leads, and the Mitaka release > managers Brian and Olga. Well done on a very successful release, everyone :) > > Total bugs closed: 645 > > == Site Stats == > > Thanks to the lovely people at Foundation (thanks Allison!) I now have access > to more stats than I could possibly guess what to do > with, and I'm hoping to be able to share some of these with you through the > newsletter. If there's something in particular you would > like to see, then please let me know and I'll endeavour to record it here! > > So far I can tell you that docs.openstack.org had 1.63M unique pageviews in > April, down slightly from 1.72M in March, and the average > session duration is just over six minutes, looking at just under 4 pages per > session. > > == Doc team meeting == > > Next meetings: > > We'll be restarting the meeting series next week. > > Next meetings: > US: Wednesday 11 April, 19:00 UTC > APAC: Wednesday 18 April, 00:30 UTC > > Please go ahead and add any agenda items to the meeting page here: > https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting > > -- > > Keep on doc'ing! > > Lana > > https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#6_May_2016 > > -- > Lana Brindley > Technical Writer > Rackspace Cloud Builders Australia > http://lanabrindley.com __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
