[openstack-dev] What's Up, Doc? 22 July
Hi everyone, As many of you would have noticed from the email onslaught, I've been working on some Launchpad housekeeping this week. The blueprints are all tidied up now, and I intend to start on the bug list next week, so keep those email filters handy ;) I'd also like to point out the hard work Andreas has been putting in to evaluate moving our docs jobs to Ubuntu Xenial. If you notice any weirdness, please let Andreas know. == Progress towards Newton == 75 days to go! Bugs closed so far: 315 Newton deliverables: https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables Feel free to add more detail and cross things off as they are achieved throughout the release. == Speciality Team Reports == '''HA Guide: Andrew Beekhof''' Got drafted (pun intended) Started figuring out the current status and direction '''Install Tutorials: Lana Brindley''' Next meeting: 2 August 0600 UTC '''Networking Guide: Edgar Magana''' No report this week. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' No report this week. '''Ops Guide: Shilla Saebi, Darren Chan''' Started a weekly Arch Guide working group meeting on Wednesday 20:00 UTC. Currently drafting the Design chapter and reusing existing content. '''API Guide: Anne Gentle''' Sent email to -dev and -docs list to determine next steps for releasing openstackdocstheme and os-api-ref sphinx extension so we can get the better theming output: http://lists.openstack.org/pipermail/openstack-dev/2016-July/099373.html Released 1.4.0 of openstackdocstheme in preparation for August (hopefully) readiness of theme/extension for unifying API docs navigation. Completed updated of governance/reference/projects.yaml to indicate contributor and api docs URLs. Found that three projects have not completed migration (trove, telemetry/ceilometer, ) and found that nn projects don't use the openstackdocstheme and os-api-ref extension and then won't be included in a unified navigation solution for all OpenStack APIs. '''Config/CLI Ref: Tomoyuki Kato''' Adding Clustering service configuration options. Fixed some bugs. Updated a few CLI reference. Added python-watcherclient. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' No report this week. '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero''' All five personas are up for review on Gerrit. https://review.openstack.org/#/c/326662/ Further improvements are planned for after the basic information is merged. == HA Guide Speciality Team Update == Bogdan Dobrelya is stepping down from leading the HA Guide Speciality Team, and I would like to thank him for his hard work. I'd like to welcome Andrew Beekhof to the role, and wish him all the best. If you're interesting in helping out on the HA Guide, please let Andrew or me know and we'll get you started. == Site Stats == While 70% of our site traffic comes through Google, just under 5% comes through Baidu, beating Bing on just 1.45%. == Doc team meeting == Next meetings: The US meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-07-20 Next meetings: APAC: Wednesday 27 July, 00:30 UTC US: Wednesday 3 August, 19:00 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#22_July_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? Farewell edition
Hi everyone, I must confess, I'm feeling a little sad. This is my very last What's Up, Doc. Next week, I'll be handling the Docs PTL mantle to Alexandra Settle. I've worked with Alex in varying capacities over many years, and I have no doubt that she will be a fabulous PTL. I'm really looking forward to working with her, and seeing what new directions she's able to take this team. I want to take this opportunity to thank each and every one of you for your continued support and encouragement over the last two years (and almost-four releases!). I have had an absolute ball doing this job, and it's all because of the amazing people I get to work with every day. Of course, I'm not going anywhere just yet. I will stay on as a core contributor, and continue to help out as much as I can. In the meantime, we have a release to get out the door! We now only have 26 days until Ocata is released, please keep an eye on the docs mailing list for updates, and consider getting your hands dirty with some Install Guide testing: https://wiki.openstack.org/wiki/Documentation/OcataDocTesting == Progress towards Ocata == 26 days to go! Closed 211 bugs so far. Release tasks are being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDeliverables Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDocTesting == The Road to PTG in Atlanta == Event info is available here: http://www.openstack.org/ptg Purchase tickets here: https://pikeptg.eventbrite.com/ Docs is a horizontal project, so our sessions will run across the Monday and Tuesday of the event. We will be combining the docs event with i18n, so translators and docs people will all be in the room together. Conversation topics for Docs and i18n here: https://etherpad.openstack.org/p/docs-i18n-ptg-pike Also, a quick note that the CFP and ticket sales for *Boston in May* are now open: https://www.openstack.org/summit/boston-2017/call-for-presentations/ == Speciality Team Reports == No speciality team reports this week, as we didn't have quorum for the docs meeting. == Doc team meeting == Our next meeting will be on Thursday 9 February at 2100 UTC in #openstack-meeting-alt Meeting chair will be Alexandra Settle. For more meeting details, including minutes and the agenda: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting -- Keep on doc'ing! Lana https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#27_January_2017 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] What's Up, Doc? Farewell edition
On 27/01/17 12:08, Chris Smart wrote: > On Fri, Jan 27, 2017 at 11:17:11AM +1000, Lana Brindley wrote: >> Hi everyone, >> >> I must confess, I'm feeling a little sad. This is my very last What's Up, >> Doc. Next week, I'll be handling the Docs PTL mantle to Alexandra Settle. >> I've worked with Alex in varying capacities over many years, and I have no >> doubt that she will be a fabulous PTL. I'm really looking forward to working >> with her, and seeing what new directions she's able to take this team. I >> want to take this opportunity to thank each and every one of you for your >> continued support and encouragement over the last two years (and almost-four >> releases!). I have had an absolute ball doing this job, and it's all because >> of the amazing people I get to work with every day. Of course, I'm not going >> anywhere just yet. I will stay on as a core contributor, and continue to >> help out as much as I can. >> > > Congrats Alex, I'm confident you will do a fabulous job! > > > Lana, from what I've seen you've been a great PTL and it will be great > to still have you around. Thanks for your leadership and support! Great > job. > > > -c > d'aww, thanks Chris :) L -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [OpenStack-docs] What's Up, Doc? Farewell edition
Thanks Shilla, it was a pleasure :) L On 27/01/17 14:27, Shilla Saebi wrote: > We will miss you Lana, you did a phenomenal job and welcome aboard Alexandra! > > On Thu, Jan 26, 2017 at 8:17 PM, Lana Brindley <mailto:openst...@lanabrindley.com>> wrote: > > Hi everyone, > > I must confess, I'm feeling a little sad. This is my very last What's Up, > Doc. Next week, I'll be handling the Docs PTL mantle to Alexandra Settle. > I've worked with Alex in varying capacities over many years, and I have no > doubt that she will be a fabulous PTL. I'm really looking forward to working > with her, and seeing what new directions she's able to take this team. I want > to take this opportunity to thank each and every one of you for your > continued support and encouragement over the last two years (and almost-four > releases!). I have had an absolute ball doing this job, and it's all because > of the amazing people I get to work with every day. Of course, I'm not going > anywhere just yet. I will stay on as a core contributor, and continue to help > out as much as I can. > > In the meantime, we have a release to get out the door! We now only have > 26 days until Ocata is released, please keep an eye on the docs mailing list > for updates, and consider getting your hands dirty with some Install Guide > testing: https://wiki.openstack.org/wiki/Documentation/OcataDocTesting > <https://wiki.openstack.org/wiki/Documentation/OcataDocTesting> > > == Progress towards Ocata == > > 26 days to go! > > Closed 211 bugs so far. > > Release tasks are being tracked here: > https://wiki.openstack.org/wiki/Documentation/OcataDeliverables > <https://wiki.openstack.org/wiki/Documentation/OcataDeliverables> > Install Guide testing is being tracked here: > https://wiki.openstack.org/wiki/Documentation/OcataDocTesting > <https://wiki.openstack.org/wiki/Documentation/OcataDocTesting> > > == The Road to PTG in Atlanta == > > Event info is available here: http://www.openstack.org/ptg > Purchase tickets here: https://pikeptg.eventbrite.com/ > <https://pikeptg.eventbrite.com/> > > Docs is a horizontal project, so our sessions will run across the Monday > and Tuesday of the event. We will be combining the docs event with i18n, so > translators and docs people will all be in the room together. > > Conversation topics for Docs and i18n here: > https://etherpad.openstack.org/p/docs-i18n-ptg-pike > <https://etherpad.openstack.org/p/docs-i18n-ptg-pike> > > Also, a quick note that the CFP and ticket sales for *Boston in May* are > now open: > https://www.openstack.org/summit/boston-2017/call-for-presentations/ > <https://www.openstack.org/summit/boston-2017/call-for-presentations/> > > == Speciality Team Reports == > > No speciality team reports this week, as we didn't have quorum for the > docs meeting. > > == Doc team meeting == > > Our next meeting will be on Thursday 9 February at 2100 UTC in > #openstack-meeting-alt > > Meeting chair will be Alexandra Settle. > > For more meeting details, including minutes and the agenda: > https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting > <https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting> > > -- > > Keep on doc'ing! > > Lana > > https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#27_January_2017 > <https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#27_January_2017> > > -- > Lana Brindley > Technical Writer > Rackspace Cloud Builders Australia > http://lanabrindley.com > > > ___ > OpenStack-docs mailing list > openstack-d...@lists.openstack.org > <mailto:openstack-d...@lists.openstack.org> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs > <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs> > > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [all][elections] PTL nomination period is now over
Hi Kendall, I'd like to discuss the future of the UX project with you, if that's OK? Lana On 30/01/17 11:05, Kendall Nelson wrote: > Hello All! > > PTL Nomination is now over. The official candidate list is available on the > election website[0]. > > There is only 1project without candidates, so according to this > resolution[1], the TC we'll have to appoint a new PTL for OpenStack UX. > > There are 5projects that will have an election: Ironic, Keystone, Neutron, > Quality Assurance and Stable Branch Maintenance.The details for those will be > posted shortly after we setup the CIVS system. > > Thank you, > > [0]: http://governance.openstack.org/election/# > <http://governance.openstack.org/election/#pike-ptl-candidates>pike > <http://governance.openstack.org/election/#pike-ptl-candidates>-ptl-candidates > <http://governance.openstack.org/election/#pike-ptl-candidates> > [1]: > http://governance.openstack.org/resolutions/20141128-elections-process-for-leaderless-programs.html > > > __ > 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 > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [all][elections] PTL nomination period is now over
On 30/01/17 14:15, Steve Martinelli wrote: > On Sun, Jan 29, 2017 at 8:05 PM, Kendall Nelson <mailto:kennelso...@gmail.com>> wrote: > > PTL Nomination is now over. The official candidate list is available on > the election website[0]. > > > It's great to see only 1 project was without a PTL! > > > There is only 1project without candidates, so according to this > resolution[1], the TC we'll have to appoint a new PTL for OpenStack UX. > > > The UX project was briefly discussed at a recent TC meeting (see the end of > the log) [1], with Piet stepping down there was some discussion about whether > or not it needs to be a standalone project, or can turn into a working group > (like the API working group). > > Oh, Thierry sent something out to the mailing list already [2], no replies :( > > [1] > http://eavesdrop.openstack.org/meetings/tc/2017/tc.2017-01-03-20.00.log.html > [2] > http://lists.openstack.org/pipermail/openstack-dev/2017-January/109622.html > Ah, thanks Steve. I'll digest this and then reply on that thread :) Lana -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [ux] Future of the OpenStack UX team
Hi Thierry, Sorry for not noticing this thread and replying earlier. I've now reviewed the minutes from the meeting, and I support thingee's suggestion of having a UX working group. This way, UX can get the attention it rightly deserves. Without the research and guidelines provided by the UX team, user-facing projects (such as Docs) will be poorer. I believe that it's in Foundations best interests to ensure that UX work is ongoing, and adequately supported, in the same way as Marketing and other user outreach services. I am happy to work with Foundation (on behalf of the Docs team) to determine how this would work in practice. Thanks, Lana On 05/01/17 00:43, Thierry Carrez wrote: > Hi everyone, > > Piet recently reached out to me to explain that he won't be able to > continue in his role as OpenStack UX team's PTL. Since he created the > team and spent a lot of time coordinating its activities, that raises > the question of the future of the OpenStack UX team. > > The situation was discussed at the TC meeting yesterday[1] and the > general feeling was that there was a lot of value in a separate team > centralizing things like Persona definition and facilitating > properly-conducted UX surveys. That said, if nobody is able to dedicate > the time that effort needs, we could also disband the centralized team > and encourage every project to adopt the tools and techniques that were > built and introduced by the UX team in the past years. > > So... What are your thoughts on those options ? Do we have a volunteer > (or more than one) to take over UX PTLship ? > > [1] > http://eavesdrop.openstack.org/meetings/tc/2017/tc.2017-01-03-20.00.log.html#l-404 > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] Supporting our global community
Jonathon, Mark, Lauren, and the rest of the Foundation staff, Thank you for this important note. Is Foundation able to provide some concrete assurance that they will continue to ensure that availability of visas is to be prioritised for future OpenStack events? Additionally, that you will not run events in countries that do not reflect OpenStack values of diversity? Lana On 30/01/17 04:34, Jonathan Bryce wrote: > OpenStack is a global open source community. The OpenStack Foundation serves > members in 180 countries focused on advancing the capabilities and > accessibility of open infrastructure everywhere. We fundamentally believe > diversity and collaboration are a powerful force for innovation, and it has > been amazing to see the product of tens of thousands of people around the > world over the last 6+ years. > > Lauren, Mark and I disagree with the executive order issued by President > Trump that targets individuals from 7 countries. The order restricts the > travel and movement of people in a discriminatory way that results in a > restriction on access to talent and ideas. It is still unclear how the > policies will play out and be enforced, but we will be watching, advocating > for and supporting our community members to the best of our ability. > > This executive order will not impact the governance of the Foundation or the > way the community operates globally. We will continue to support user groups > and community members that are active in the seven countries named by the > executive order, alongside our 120+ user groups around the world. However, we > have two scheduled events in the United States within the next six months > that will attract a global audience: the PTG (Project Teams Gathering) in > Atlanta, Feb 20-24, a smaller event that will bring together hundreds of > upstream contributors, and the OpenStack Summit in Boston, May 8-11, our > larger event that happens every six months. > > This executive order could impact some community members' ability to travel > to Atlanta and Boston, but unfortunately it is too late at this point to > change the location of these events. The following three OpenStack Summits, > however, are now scheduled to occur outside of the United States. The next > Summit will be in November 2017 in Sydney, Australia and we are working to > finalize the details so we can announce the following two Summit locations > soon. > > We’ve already heard from one community member, Mohammed Naser, who is > concerned that his plans to travel from Canada to Atlanta to attend the PTG > may be restricted, simply because he a dual citizen of Canada and Iraq. > Mohammed has been contributing code to OpenStack since 2011 and is the CEO > and Founder of Vexxhost. Blocking his travel would serve no purpose and rob > the community of a valuable contributor during an important event. If you are > concerned about the impact or have any questions, please don't hesitate to > reach out to me at jonat...@openstack.org. > > Political actions like this highlight the importance of our collective > values. The Four Opens, the founding principles of our community, exist to > ensure the free flow of talent and ideas, across geographic, national, > organizational or other lines that might divide us. We believe in humanity. > We believe in opportunity. We believe in the power of collaboration across > borders, and we will continue to carry forward our mission. > > We also posted this online: > https://www.openstack.org/blog/2017/01/supporting-our-global-community/ > > Jonathan Bryce > Mark Collier > Lauren Sell > > > > __ > 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 > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [all][elections] PTL nomination period is now over
Yes, I replied on the other thread. Thanks :) L On 30/01/17 16:48, Kendall Nelson wrote: > Yes of course :) Did you want to schedule a meeting or just discuss here > more? > > I've seen some discussion about making UX to a working group? > > -Kendall (diablo_rojo) > > On Sun, Jan 29, 2017, 7:46 PM Lana Brindley <mailto:openst...@lanabrindley.com>> wrote: > > Hi Kendall, > > I'd like to discuss the future of the UX project with you, if that's OK? > > Lana > > On 30/01/17 11:05, Kendall Nelson wrote: > > Hello All! > > > > PTL Nomination is now over. The official candidate list is available on > the election website[0]. > > > > There is only 1project without candidates, so according to this > resolution[1], the TC we'll have to appoint a new PTL for OpenStack UX. > > > > There are 5projects that will have an election: Ironic, Keystone, > Neutron, Quality Assurance and Stable Branch Maintenance.The details for > those will be posted shortly after we setup the CIVS system. > > > > Thank you, > > > > [0]: http://governance.openstack.org/election/# > <http://governance.openstack.org/election/#pike-ptl-candidates>pike > <http://governance.openstack.org/election/#pike-ptl-candidates>-ptl-candidates > <http://governance.openstack.org/election/#pike-ptl-candidates> > > [1]: > http://governance.openstack.org/resolutions/20141128-elections-process-for-leaderless-programs.html > > > > > > > __ > > OpenStack Development Mailing List (not for usage questions) > > Unsubscribe: > openstack-dev-requ...@lists.openstack.org?subject:unsubscribe > <http://openstack-dev-requ...@lists.openstack.org?subject:unsubscribe> > > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > -- > 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://openstack-dev-requ...@lists.openstack.org?subject:unsubscribe> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > __ > 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 > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [openstack-docs][security] Sec guide change
Nice work! L On 03/02/17 05:06, Alexandra Settle wrote: > Hi everyone, > > > > As of today, all bugs for the Security Guide will be managed by > ossp-security-documentation and no longer will be tracked using the OpenStack > manuals Launchpad. > > > > All tracking for Security Guide related bugs can be found here: > https://bugs.launchpad.net/ossp-security-documentation > > > > Big thanks to the security team and Ian Cordasco for creating and updating > the bug list in Launchpad! > > > > Thank you, > > > > Alex > > > > __ > 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 > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [All] IRC Mishaps
On 09/02/17 06:36, Kendall Nelson wrote: > Hello All! > > So I am sure we've all seen it: people writing terminal commands into our > project channels, misusing '/' commands, etc. But have any of you actually > done it? > > If any of you cores, ptls or other upstanding members of our wonderful > community have had one of these embarrassing experiences please reply! I am > writing an article for the SuperUser trying to make us all seem a little more > human to people new to the community and new to using IRC. It can be scary > asking questions to such a large group of smart people and its even more off > putting when we make mistakes in front of them. > > So please share your stories! What about the one where you're conducting a private conversation in one window, and watching a group chat in another one, and then drop some deeply personal (or embarrassing!) content in the group chat instead the PM ;) L -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] Fwd: Docs project mascot
Hi everyone, Here's the final docs logo from Foundation. Lana Forwarded Message Subject:Docs project mascot Date: Mon, 13 Feb 2017 13:38:46 -0800 From: Heidi Joy Tretheway To: Alexandra Settle , Lana Brindley Hi Lana and Alexandra, I’m excited to finally be able to share final project logo files with you. Inside this folder, you’ll find full-color and one-color versions of the logo, plus a mascot-only version, in EPS, JPG and PNG formats. You can use them on presentations and wherever else you’d like to add some team flair. https://www.dropbox.com/sh/htu234yuf963i9b/AAAsraXwT3a5O9HNmms4E9yFa?dl=0 At the PWG, we’ll have stickers for your team of the mascot, plus signage on your room. I’m especially excited for the project teams to see all of the logos together as one group, because they work beautifully together stylistically while making each project’s mark distinctive. Feel free to share this with your team, and thanks to you and to them for the hard work they put into reaching an agreement on the mascot. Also feel free to direct any questions my way! photo *Heidi Joy Tretheway* Senior Marketing Manager, OpenStack Foundation 503 816 9769 | Skype: heidi.tretheway <https://webapp.wisestamp.com/sig_iframe?origin=mac-mail&signature_id=5499768844845056&t=0.9726545857097719#> <http://linkedin.com/in/heiditretheway> <http://twitter.com/heiditretheway> <http://www.openstack.org/> signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] Fwd: Documentation logo - revised
And here's our logo with our whole name written on it :) L Forwarded Message Subject:Documentation logo - revised Date: Fri, 17 Feb 2017 13:30:26 -0800 From: Heidi Joy Tretheway To: Alexandra Settle , Lana Brindley Here are the updated files for Documentation! Have a great weekend. https://www.dropbox.com/sh/htu234yuf963i9b/AAAsraXwT3a5O9HNmms4E9yFa?dl=0 photo *Heidi Joy Tretheway* Senior Marketing Manager, OpenStack Foundation 503 816 9769 | Skype: heidi.tretheway <https://webapp.wisestamp.com/sig_iframe?origin=mac-mail&signature_id=5499768844845056&t=0.9726545857097719#> <http://linkedin.com/in/heiditretheway> <http://twitter.com/heiditretheway> <http://www.openstack.org/> signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 29 July
Hi everyone, A fairly quiet week this week, as I've been gradually working my way through old bugs. We're now only ten weeks out from release, so I've also been trying to tidy up some loose ends around the Contributor Guide. We have a couple of specs out for review right now, so if you're looking for some docs work to pick up, try checking these out: https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z == Progress towards Newton == 68 days to go! Bugs closed so far: 339 Newton deliverables: https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables Feel free to add more detail and cross things off as they are achieved throughout the release. == Speciality Team Reports == '''HA Guide: Andrew Beekhof''' Informal discussions about appropriate contents and structure '''Install Tutorials: Lana Brindley''' Next meeting: 2 August 0600 UTC '''Networking Guide: Edgar Magana''' Guide re-organization patch has been merged: https://review.openstack.org/#/c/345110/ '''Security Guide: Nathaniel Dillon''' Performing full read-through and bug hunt Opened 5 new bugs Currently looking at Neutron chapter Incoming addition on rate-limiting and anti-DDoS (framework merged tonight (thanks Kato!) and additional details coming) '''User Guides: Joseph Robinson''' No report this week. '''Ops Guide: Shilla Saebi, Darren Chan''' Weekly Arch Guide working group meeting on Wednesday 20:00 UTC in progress. Currently drafting the Design chapter and reusing existing content. Working on getting more enterprise docs uploaded and pushed upstream for ops guide '''API Guide: Anne Gentle''' First App tutorial for the Shade SDK now moving out of draft state. Way to go Marcela Bonell and infra people who make this SDK possible. Thank you to Kato Tomoyuki for deletions of the Image and Networking WADL files in api-site. This ongoing dedication and cleanup is super valuable and much appreciated. '''Config/CLI Ref: Tomoyuki Kato''' Reflecting comments from Stackers. Closed a few bugs for Configuration Reference. Working on the common configurations. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' No report this week. '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero''' No report this week. == Site Stats == Just under 55% of our mobile visitors are using an Android operating system to access the site, while just under 40% of our mobile visitors are using iOS. A statistically insignificant 0.07% are still using their Blackberries ... == Doc team meeting == Next meetings: The APAC meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-07-27 Next meetings: US: Wednesday 3 August, 19:00 UTC APAC: Wednesday 10 August, 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#29_July_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 12 August
Hi everyone, I have been struck down with flu yet again this week, so a quiet one from me (I'll be glad when winter is over, let me tell you!). Anne, however, has been kicking it out of the park with her work on the API docs; I suggest you take a look at the update she sent to the mailing lists the other day to catch up: http://lists.openstack.org/pipermail/openstack-dev/2016-August/101380.html == Progress towards Newton == 54 days to go! Bugs closed so far: 365 Newton deliverables: https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables Feel free to add more detail and cross things off as they are achieved throughout the release. == Speciality Team Reports == '''HA Guide: Andrew Beekhof''' No report this week. '''Install Tutorials: Lana Brindley''' Next meeting: 16 August 0600UTC '''Networking Guide: Edgar Magana''' No report this week. '''Security Guide: Nathaniel Dillon''' Bug hunt continued, all contributions are welcome, grammatical and technical alike! Focusing on the last half of the SecurityGuide, and the 'freshness' of code examples Threat analysis documentation and templates added '''User Guides: Joseph Robinson''' The Consistency and Editing patch is ready to merge, and just needs more reviews https://review.openstack.org/#/c/347641/ . Some pages in the User Guides are resulting in 404s (dashboard manage shares for example), and this bug is tracking the changes https://bugs.launchpad.net/openstack-manuals/+bug/1611792 Thanks to Maria for taking on the file name changes to the User Guide, and Anne for also patching the Admin Guide file names! '''Ops Guide: Shilla Saebi, Darren Chan''' Working on storage, networking, and compute sections in the Arch Guide. Arch Guide working group proposed a series of short sprints, working in pairs as SME/writer. Dates TBD Waiting on enterprise ops documentation to migrate to the Ops Guide. '''API Guide: Anne Gentle''' Ceilometer migrated content has landed! \o/ https://review.openstack.org/334028 Many thanks to Khushbu Parakh for sticking with it, and to Julien Danjou and Gordon Chung for accepting the (rather outdated) migrated content and taking responsiblity for it from now on. Working on a template for http-status.yaml file that teams can use for new pretty HTTP Status code tables that just landed last week. https://review.openstack.org/#/c/351835/ Ever closer to landing the API reference navigation. https://review.openstack.org/#/c/329508/ Refer to status report on -dev and -docs mailing lists: http://lists.openstack.org/pipermail/openstack-dev/2016-August/101380.html '''Config/CLI Ref: Tomoyuki Kato''' Closed a few bugs with mitaka backport. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' Updating Upstream training for the next OpenStack Summit (https://etherpad.openstack.org/p/upstream-university-improvements) Next meeting: Monday 15 August 1700 UTC in #openstack-meeting '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero''' No report this week. == Site Stats == This week, 385 visitors came to the docs site from Stack Overflow, 423 visitors came via searching on duckduckgo, and 508 came from ask.openstack.org. == Doc team meeting == Next meetings: The APAC meeting failed to make quorum this week, but thanks to Darren for trying anyway :) Next meetings: US: Wednesday 17 August, 19:00 UTC APAC: Wednesday 24 August, 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#12_August_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] What's Up, Doc? 19 August (Correction)
On 19/08/16 14:59, Lana Brindley wrote: > > == Doc team meeting == > > Next meetings: > > The US meeting failed to make quorum this week. We're seeing this a lot > recently, is there still a need for a regular docs meeting? > A correction: US meeting *did* go ahead this week, minutes are here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-08-17 Please excuse me while I try to work out how to use eavesdrop. > Next meetings: > APAC: Wednesday 24 August, 00:30 UTC > US: Wednesday 31 August, 19:00 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#19_August_2016 > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 19 August
Hi everyone, Watch out, Install Guide testing season is about to begin! If you're a package maintainer, cross-project liaison, or just a helpful testing regular, look out for an email from me real soon now! In the meantime, keep hitting those bugs, and letting us know if you spot any problems in the guide. == Progress towards Newton == 47 days to go! Bugs closed so far: 371 Newton deliverables: https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables Feel free to add more detail and cross things off as they are achieved throughout the release. == Speciality Team Reports == '''HA Guide: Andrew Beekhof''' Some reviews, nothing interesting '''Install Tutorials: Lana Brindley''' Core Guide testing to kick off Real Soon Now (tm). Next meeting: 30 August 0600UTC. '''Networking Guide: Edgar Magana''' No report this week. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' No report this week. '''Ops Guide: Shilla Saebi, Darren Chan''' Reorganized monitoring content in the Ops Guide Migrating ops, legal, and security content in the Arch Guide Working on use cases chapter and design chapter in the Arch Guide '''API Guide: Anne Gentle''' No report this week. '''Config/CLI Ref: Tomoyuki Kato''' A few cleanups are under going. Updated some client references. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' No report this week. '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero''' No report this week. == Site Stats == Just under 90,000 sessions on the docs site this week. == Doc team meeting == Next meetings: The US meeting failed to make quorum this week. We're seeing this a lot recently, is there still a need for a regular docs meeting? Next meetings: APAC: Wednesday 24 August, 00:30 UTC US: Wednesday 31 August, 19:00 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#19_August_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 26 August
Hi everyone, This week marks six weeks left to the Newton release, so I've been busy getting everything prepared. We're now ready to start testing the core Installation Tutorial, so check out the wiki and get signed up: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting#Testers We've also selected two new release managers to assist with this release, please welcome Olena and Alex! More on those topics in this newsletter. == Progress towards Newton == 40 days to go! Bugs closed so far: 387 Release planning: https://etherpad.openstack.org/p/NewtonRelease == Release Managers == There was an overwhelming response to my request for release managers, which was very cool! The first two responders were Olena Logvinova and Alexandra Settle , so please welcome them to the release team. Their main role during this process is to make sure that all the tasks we have to complete get done accurately and on schedule. It's an important job, and we're really glad to have you both on board. == Install Tutorial Testing == Install Tutorial testing is just about ready to kick off. If you're interested in helping, make sure you've added your name on to the list on our testing wiki page: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting (if you don't have wiki access, just email me directly and I'll add you in). Thanks to our package maintainers, we now have b2 pre-release packages ready for Ubuntu and Debian, so those are ready to be tested. == Docs Tools == I'm very pleased to announce that we have now removed DocBook from our build tools. The end of an era! Thanks to Anne, Andreas, and David Cramer for keeping this project alive for so long, and eventually seeing it come to fruition. Version 1.5.0 of openstackdoccstheme was released this week. In other tools news, there are plans afoot to move developer.openstack.org and docs.openstack.org away from Rackspace Cloudsites, and on to pages that OpenStack Infra control. This has been on the proverbial backburner for a long time, but the Infra team is now in a position to make it happen. You can read and comment on the Infra spec here: https://review.openstack.org/#/c/276482/ == Speciality Team Reports == '''HA Guide: Andrew Beekhof''' No report this week. '''Install Tutorials: Lana Brindley''' Core Guide testing is underway! Check out progress and sign up here: https://wiki.openstack.org/wiki/Documentation/MitakaDocTesting Next meeting: 30 August 0600UTC. '''Networking Guide: Edgar Magana''' Attending the OpenStack East in NYC. No report this week. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' No report this week. '''Ops Guide: Shilla Saebi, Darren Chan''' No report this week. '''API Guide: Anne Gentle''' Releasing openstackdocstheme with new sidebar and integration with os-api-ref Sphinx Extension. Many thanks to Karen Bradshaw, Sean Dague, Graham Hayes, Andreas Jaeger (and anyone I may have missed!) for their tireless efforts on this release. WOW. '''Config/CLI Ref: Tomoyuki Kato''' Merged some patches, updated a few CLI reference, nothing special. '''Training labs: Pranav Salunke, Roger Luethi''' Some minor changes, backports of features. The parser is almost done. https://github.com/dguitarbite/rst2bash Updated the openstack-manuals, install-guides with the new syntax which is parser friendly. I should start sending the required patches to manuals repo. soon after finalizing the syntax.. https://github.com/dguitarbite/openstack-manuals/commit/c9e7e1bb2c7269f02a757768dd2dd309fa2233ac '''Training Guides: Matjaz Pancur''' Upstream training improvement (https://etherpad.openstack.org/p/upstream-university-improvements). Please consider participating in the Remote content sprint (proposed timeframe: first half of September, see etherpad for details). '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero''' No report this week. == Site Stats == Keystone and Ceph are this week's most popular search terms. == Doc team meeting == Next meetings: The APAC meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-08-24 Next meetings: US: Wednesday 31 August, 19:00 UTC APAC: Wednesday 7 September, 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/D
[openstack-dev] What's Up, Doc? 2 September
Hi everyone, We have five weeks left until the Newton release goes out, so this week has been all about getting started on testing the Install Guide. We now have beta releases for all our distros, so thanks to our lovely package maintainers for getting back to me so quickly! We can still use more testers, though, all you need to do is sign up on the wiki page and start testing: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting This week Andreas, Brian, Olga, and I will be meeting with our new release managers Olena and Alex, to make sure they're up to speed. Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release. == Progress towards Newton == 33 days to go! Bugs closed so far: 407 Release managers: Olena Logvinova and Alexandra Settle Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting == The Road to Barcelona == * If there's something you want to make sure we discuss at Summit, please put your ideas here: https://etherpad.openstack.org/p/Ocata-DocsSessions When we get our room allocations, I'll organise it into a schedule. * Talk acceptances have gone out, congratulations to everyone who got something accepted! * If you require a visa invitation letter to travel to Spain, then you need to fill out the form here: https://www.openstack.org/summit/barcelona-2016/travel/#visa == Docs Tools == There is a lot of cleanup happening on the docs site right now, so you might see some old and unloved content disappear. If you notice anything strange, please let Andreas or the docs mailing list know so we can get it straightened out. == Speciality Team Reports == '''HA Guide: Andrew Beekhof''' No report this week. '''Install Tutorials: Lana Brindley''' Core Guide testing is underway! Check out progress and sign up here: https://wiki.openstack.org/wiki/Documentation/MitakaDocTesting Next meeting: 13 September August 0600UTC. '''Networking Guide: Edgar Magana''' No report this week. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' No report this week. '''Ops Guide: Shilla Saebi, Darren Chan''' No meeting last week in light of the ops mid cycle and OpenStack East conference Updating use cases chapter in Arch Guide Looking for more enterprise troubleshooting docs to push upstream for the ops guide '''API Guide: Anne Gentle''' New landing page for a collection of all API Reference docs and Guides in one place: https://review.openstack.org/#/c/361480/ Improvements to the sidebar link collection: https://review.openstack.org/#/c/362436/ '''Config/CLI Ref: Tomoyuki Kato''' Updated some CLI reference. Closed some bugs for Config Reference. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' No report this week. '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero''' No report this week. == Site Stats == For the month of August, we had a 6% increase in traffic over July. == Doc team meeting == Next meetings: The US meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-08-31 Next meetings: APAC: Wednesday 7 September, 00:30 UTC US: Wednesday 14 September, 19:00 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#2_September_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [all] Timeframe for future elections & "Release stewards"
On 08/09/16 04:46, Matt Riedemann wrote: > On 9/7/2016 11:33 AM, Jim Rollenhagen wrote: >> >> I like this. As someone that has been PTL for multiple cycles, it is >> incredibly stressful trying to finish the release, start planning for the >> next one, manage summit planning, etc. I'd love to have someone >> designated to manage the release-specific bits of the project, while >> PTLs can worry about the longer-term vision of the project and the >> day-to-day management. >> >> Thanks for writing this up, Thierry. :) >> >> // jim >> > > I don't really see how managing the release-specific bits of the project as a > 'release steward' is different from a release cross-project liaison. Nova has > a release CPL (really more than one probably informally). > > I do think it's a bit weird that I've already slotted the Ocata design summit > rooms for Nova when someone else could be PTL, but I don't think what I'd > reserve would be drastically different from someone else in Nova, this is why > we have trust relationships and talk about stuff as a team. There was a lot > of overlap from Michael to John and from John to myself and we've shared > responsibilities during those transitions. > > The release steward concept just seems like unnecessarily complexity and > formality to me, but that's just my opinion. Things might work differently in > other projects. > Although I appreciate that my project is probably a bit different to many of the others (horizontal vs vertical, etc), I much prefer this method of overlapping the PTL changeover a little more instead of appointing form stewards. In docs, we've started assigning two release managers about a month before release time. They work with the PTL and other core team members to make sure the release happens smoothly, which allows the PTL the luxury of knowing there's eyes on all those small pieces that need to happen to get the release out while they get on with Summit prep. This means that having a formal release steward would just mean we appoint that person earlier in the cycle, so there's no real change for us in Thierry's proposal. We did this for a lot of reasons, at least some of which are about training people to understand the project on a deeper level (and thus create a leadership pipeline, of sorts). Having the PTL changeover time increase would have helped greatly during the time I was taking over as PTL from Anne. Like I said, docs is a little different, we have very little PTL-churn, which means that changeover process is a lot more complicated and involves a lot more information exchange than other projects that regularly change PTLs, I think. So I think this would be good for us, but accept that it might not work so well for other projects. Lana -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 9 September
Hi everyone, Only four weeks to go until Newton! Andreas, Brian, Olga, and I met with our new release managers Olena and Alex a few days ago, and we're all ready and waiting with bated breath to get started on the release. Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release. This week, I've also done a core team review, and we bid farewell to two core team members. More on that in this newsletter. == Progress towards Newton == 26 days to go! Bugs closed so far: 428 Release managers: Olena Logvinova and Alexandra Settle Release tasks are being tracked here: https://etherpad.openstack.org/p/NewtonRelease Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting == The Road to Barcelona == * If there's something you want to make sure we discuss at Summit, please put your ideas here: https://etherpad.openstack.org/p/Ocata-DocsSessions When we get our room allocations, I'll organise it into a schedule. * If you require a visa invitation letter to travel to Spain, then you need to fill out the form here: https://www.openstack.org/summit/barcelona-2016/travel/#visa Looking a little further forward, Foundation have now announced that the first Project Team Gathering (PTG) will be held in Atlanta, US, on Feb 20-24: http://www.openstack.org/ptg == Core Team Review == The core team have completed their review for August, and I'm a bit sad to announce that both Atsushi Sakai and Gauvain Pocontek are no longer core team members. Gauvain has been committing to OpenStack manuals since well before my time, and has been an invaluable resource for many people (including myself!) over the years. He is currently working on some new projects, but we hope to still see him around from time to time. Atsushi-san joined the core team last year, and during that time has proven an extremely effective reviewer. He is still very busy on OpenStack, with an increased focus on cross-project tasks, so we will be sure to still see him around. I wish you well on your endeavours! I thank you both for your commitment to being core team members, and for all your contributions. We are better because of your effort. == Speciality Team Reports == '''HA Guide: Andrew Beekhof''' Organizing a HA meetup at summit Intention is get an update plan finalized shortly '''Install Tutorials: Lana Brindley''' Core Guide testing is underway! Check out progress and sign up here: https://wiki.openstack.org/wiki/Documentation/MitakaDocTesting Next meeting: 13 September August 0600UTC. '''Networking Guide: Edgar Magana''' No report this week. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' No report this week. '''Ops Guide: Shilla Saebi, Darren Chan''' No report this week. '''API Guide: Anne Gentle''' Working on an article for Super User describing the switchover in API guide sources to project repos and the new navigation. '''Config/CLI Ref: Tomoyuki Kato''' Consolidating the OSC command reference into the OSC specific doc. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' Finished first day of our virtual sprint series (6 Sep): Common items: https://etherpad.openstack.org/p/upstream-uni-common-items (coordinated by Ildiko Vancsa, ildikov), Code contribution: https://etherpad.openstack.org/p/upstream-uni-code-contribution (coordinated by Kendall Nelson, diablo_rojo) Next virtual sprint dates: 12,13 and 16 September (https://wiki.openstack.org/wiki/VirtualSprints#Upstream_training_Sprint) '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero''' No report this week. == Doc team meeting == Next meetings: The APAC meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-09-07 Next meetings: US: Wednesday 14 September, 19:00 UTC APAC: Wednesday 21 September, 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#9_September_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] [Docs][PTL] PTL Candidacy for Docs
Hi everyone, I am seeking re-election as Documentation PTL for Ocata. I have been the docs PTL since Liberty, and together we've converted the entire docs suite to RST, decommissioned the old DocBook infrastructure, and fundamentally changed the way projects document their installation procedures. Ocata is a short cycle, so I want to take this opportunity to focus inwards on our community. I would love your support to do this in Ocata. In Mitaka we embarked on an ambitious plan to convert our entire documentation suite to RST, and in Newton we put the finishing touches to that project by decommissioning the old DocBook infrastructure. With that long-term project complete, we have gone on to develop a new publication model that allows projects to write documentation in their own repos, and publish seamlessly to the docs.openstack.org front page. This project goes live for the Installation Guide and API docs with Newton, and means our documentation efforts are continuing to scale out to represent a much greater proportion of products, contributors, operators, and users. I would like to continue this work in Ocata by evaluating the success of the project, and identifying more efficient and productive pathways for users to find and use the information provided by the docs team. I also want to explore more innovative ways for the documentation team to work together, including a review of the speciality team and release processes. I want to continue to foster collaboration between developers and writers to provide the best possible documentation for the entire OpenStack community. During Newton, in addition to the Installation Guide changes, we focussed on streamlining our processes, clarifying the way we operate, consolidating guides, and general editing and tidying up. I want to continue this work in Ocata to provide a better documentation experience for everyone: writers, developers, operators, and users. In the Liberty release cycle, we closed just over 600 bugs, and in Mitaka we closed 645. With the rate of new bug creation rapidly dropping thanks to procedural changes we made in Mitaka, our consistent effort has really paid down a lot of our technical debt. For Newton so far, we've closed well over 400 bugs, and we have only 327 bugs in the queue as I write this, so this positive trend continues. I'll be making the trek to Barcelona soon for the Ocata summit, to catch up with old friends and hopefully meet some of our newest contributors. Please be sure to stop for a chat if you see me around. I'm also excited about the new Project Team Gathering coming up in February; I think this will be a great opportunity for cross-project teams like docs. I'd love to have your support for the PTL role for Ocata. I'm looking forward to continuing to grow the documentation team and to keep working on these incremental improvements to content delivery. Thanks, Lana (@loquacities) https://review.openstack.org/#/c/370477/ -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 16 September
Hi everyone, Newton goes out in three weeks, and the release team and I have been busy working with our cross-project liaisons to ensure the docs suite is up to date and ready to go. Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release. This week, I've also been working on Summit planning, and drafting my PTL candidacy, which you can read here: http://lists.openstack.org/pipermail/openstack-docs/2016-September/009112.html Big thanks to everyone who has emailed me over the past few days to offer their support. Knowing you all have my back is the reason I keep doing this :) == Progress towards Newton == 19 days to go! Bugs closed so far: 444 Release managers: Olena Logvinova and Alexandra Settle Release tasks are being tracked here: https://etherpad.openstack.org/p/NewtonRelease Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting == The Road to Barcelona == * I have a draft schedule starting to take shape, which you can see here: https://etherpad.openstack.org/p/Ocata-DocsSessions I'll put this into Sched once the tool becomes available, and your early feedback is welcome. Additionally, if you're interested in moderating a session in Barcelona, please let me know. * By now, you should be well on the way to having your travel and accommodation booked for Barcelona. In case you're still working on it, though, there's travel information available on the Summit site here: https://www.openstack.org/summit/barcelona-2016/travel/ * Looking a little further forward, Foundation have now announced that the first Project Team Gathering (PTG) will be held in Atlanta, US, on Feb 20-24: http://www.openstack.org/ptg == Speciality Team Reports == This will be the last Speciality Team report before we release Newton, as focus shifts to final preparations, testing, and release notes. I'd like to take this opportunity to thank all our speciality team leads, who work very hard behind the scenes to keep their books in top shape, and their teams working together towards a common goal. Our docs suite wouldn't be what it is without these hard working people. '''HA Guide: Andrew Beekhof''' No report this week. '''Install Tutorials: Lana Brindley''' Core Guide testing is underway! Check out progress and sign up here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting Next meeting: 27 September August 0600UTC. '''Networking Guide: Edgar Magana''' No report this week. '''Security Guide: Nathaniel Dillon''' No report this week. '''User Guides: Joseph Robinson''' No report this week. '''Ops Guide: Shilla Saebi, Darren Chan''' No report this week. '''API Guide: Anne Gentle''' Working with teams who want to write guides similar to FirstApp: Murano and Heat for example. This patch moves Cinder v1 API to Deprecated: https://review.openstack.org/#/c/370407/ Thanks Mark Voelker for all the links to go with the patch! '''Config/CLI Ref: Tomoyuki Kato''' Updating Config reference for Newton release. We need to help, especially for vendor plug-in configuration. '''Training labs: Pranav Salunke, Roger Luethi''' No report this week. '''Training Guides: Matjaz Pancur''' No report this week. '''Hypervisor Tuning Guide: Blair Bethwaite No report this week. '''UX/UI Guidelines: Michael Tullis, Rodrigo Caballero''' No report this week. == Doc team meeting == Next meetings: The US meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-09-14 Next meetings: APAC: Wednesday 21 September, 00:30 UTC US: Wednesday 28 September, 19:00 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#16_September_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [ptl] code churn and questionable changes
On 23/09/16 02:19, Amrith Kumar wrote: > Joshua, > > I think Steve and you may be missing the point of my email. It *IS* because I > want to be open and inviting that I even asked the question, and what I'm > asking for is how to deal with it. > > All Steve says is " The fact that a new-to-openstack contributor would make > such and error doesn’t warrant such a negative response even if it a hassle > for the various PTLs and core reviewer teams to deal with". > > I'm not proposing a negative response, I'm asking how to deal with it. > > What, for example, does one do if a patch is proposed virtually identically > in a half dozen (or two dozen) projects by someone and is totally bat-shit > crazy? Merely -1'ing it and offering to help in a private email is not really > the answer. I've tried it. We all have. And we keep doing it. And doing it again. > > Having a file in the projects repo that talks about guidelines for > contributions isn't it either. We have one of those. It is up to the > contributor to read it; yes, I can keep pointing contributors to that but > this is a systemic problem which I'm hoping to address. It's only systemic in the sense that it's standard human behaviour. And I doubt you'll be able to fix that with some automation. > > What does one do when a contributor continually proposes one line changes > that fix typos in comments (yes, really). At some point, these changes (while > absolutely, and unarguably valid) begin to be a drag on the community. Coach. Train. Communicate. > > What I'm asking for is something, something that may cross project > boundaries, that will help bring contributors onto openstack, and rapidly > bring them to the point where they are contributing at a level that > materially benefits the project(s). > > -amrith > Sounds like you're looking for a technical solution to a social problem. You're the PTL. Make sure there's good documentation about expected behaviours, point to it when you decline a patch, and always be available for mentoring and coaching. Yes, you will teach people the 101 version of contributing a million times over, and you'll repeat yourself ad nauseum, often to the same people. It's called leadership. If you have a truly toxic person in your midst (hint: these are rarely newcomers, you don't discover these people straight away, I've found), *then* you can do something to remove them from your community. Here's a good place to start: https://hypatia.ca/2016/06/21/no-more-rock-stars/ No one said leadership was easy. L -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 23 September
Hi everyone, Newton goes out in just two weeks, and the release team and I have been busy working through release tasks in preparation. Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release. I'm also pleased to announce that I have been returned as the documentation PTL for Ocata, which will be my fourth term. Thanks for all the support! == Progress towards Newton == 12 days to go! Bugs closed so far: 455 Release managers: Olena Logvinova and Alexandra Settle Release tasks are being tracked here: https://etherpad.openstack.org/p/NewtonRelease Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting == The Road to Barcelona == * I have a draft schedule starting to take shape, which you can see here: https://etherpad.openstack.org/p/Ocata-DocsSessions I'll put this into Sched once the tool becomes available, and your early feedback is welcome. Additionally, if you're interested in moderating a session in Barcelona, please let me know. * By now, you should be well on the way to having your travel and accommodation booked for Barcelona. In case you're still working on it, though, there's travel information available on the Summit site here: https://www.openstack.org/summit/barcelona-2016/travel/ * Looking a little further forward, Foundation have now announced that the first Project Team Gathering (PTG) will be held in Atlanta, US, on Feb 20-24: http://www.openstack.org/ptg == Doc team meeting == Next meetings: The APAC meeting was skipped this week. Next meetings: US: Wednesday 28 September, 19:00 UTC APAC: Wednesday 5 October, 00:30 UTC These two meetings will be the final meetings before release day. 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#23_September_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 30 September
Hi everyone, We're on the final countdown to Newton now! The release managers Olena and Alex are busy getting the release patches ready, the Install Guide testing team are madly working through the last few sections, and Andreas and I have our fingers hovering over the big red GO button! Don't forget that you can contact any of us (or just send mail to the docs mailing list) if you have any questions about the Newton docs release. Please be aware that the core team will not be merging non-critical patches until after we've branched for Newton, particularly for the Installation Guide. We usually cut the branch about a week after Summit concludes, so you might be asked to wait until then. If that happens, a core will -2 your patch until after we've branched. == Progress towards Newton == 5 days to go! Bugs closed so far: 466 Release managers: Olena Logvinova and Alexandra Settle Release tasks are being tracked here: https://etherpad.openstack.org/p/NewtonRelease Install Guide testing is being tracked here: https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting == The Road to Barcelona == I have a draft schedule up, which you can see here: https://etherpad.openstack.org/p/Ocata-DocsSessions I'll put this into Sched once the tool becomes available, and your early feedback is welcome. Additionally, if you're interested in moderating a session in Barcelona, please let me know. == Core Team Reviews == Just a quick note that we won't be holding a core team review in October, as it conflicts with release, or in November, as it conflicts with Summit. We'll resume these in December for the Newton cycle. == Doc team meeting == Next meetings: The US meeting was held this week, you can read the minutes here: https://wiki.openstack.org/wiki/Documentation/MeetingLogs#2016-09-28 Next meetings: APAC: Wednesday 5 October, 00:30 UTC (This will be the final meeting before release day!) US: Wednesday 12 October, 19:00 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#30_September_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] Thanks for all the fish
Hi everyone, As most of you know, I was caught up in the Rackspace layoffs that happened earlier this year, and have been looking for work (in between knee surgery) since then. Well, in good news for my bank account, I have now secured a new job with a startup based here in Brisbane. The bad news is that, while it's working on cool stuff and is likely to be at least partially open sourced at some point, there's currently no scope for me to continue working on OpenStack. Sadly, an OpenStack related position just did not come my way, despite my best efforts. So, this is goodbye for now. I'm going to unsubscribe from the OpenStack mailing lists, and resign my core positions, but you can still email me at this address if you want to. Feel free to hit me up on LinkedIn or Twitter, if that's your thing. I'm going to miss being part of the community we built here, and all the fabulous people I've met over my OpenStack years. Keep being awesome, I'll be cheering from the sidelines. Keep on Doc'ing :) Lana -- Lana Brindley Technical Writer http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?
(Adding the dev list to cc, as I think this conversation deserves a wider audience) Thanks for this feedback. I'm really glad that the new Install Guide model is working out well for people! Since our new Install Guides have only just been published, at this stage I'm intending to gather some data on how projects and users are using the project-specific Install Guides during the next cycle. I'm also intending to spend some time in the Ocata cycle on improving that index page. It's pretty ugly right now, and I think there's some serious UX improvements to be done. Since Ocata is a short cycle, I'm also conscious of how much the docs team might realistically be able to achieve. All that said, you are certainly not the first to ask if this model can be extended! I think it's something that the docs community would like to see, and it seems as though it has broad support amongst developers and projects as well. So, in short, I think this is a thing that will happen, but probably not in Ocata. I'm tentatively willing to tell you that Pike is a possibility though ;) Lana On 07/10/16 12:43, Steve Martinelli wrote: > FWIW, the keystone team would also be interested in this model > > On Thu, Oct 6, 2016 at 11:40 AM, Jay Faulkner <mailto:j...@jvf.cc>> wrote: > > Hi all, > > For those of you who don't know me, I'm Jay Faulkner and I work on Ironic > as the Docs liaison as one of my hats. > > Ironic launched our install-guide right after newton closed, and > backported it, thanks to the changes to make the install-guide available in > tree. We're a huge fan of this model, and I'm curious if there's any plans to > make this happen for the admin-guide. If not, can someone help me understand > the scope of work, presuming it's something that the docs group is interested > in. > > If we can get the technical infrastructure in place to do admin-guide in > tree, I'd expect Ironic to quickly adopt it, like we did for the install > guide. > > Thanks, > Jay Faulkner > OSIC > > > ___ > OpenStack-docs mailing list > openstack-d...@lists.openstack.org > <mailto:openstack-d...@lists.openstack.org> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs > <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs> > > > > > ___ > OpenStack-docs mailing list > openstack-d...@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? Newton Edition!
Hi everyone, First of all, Newton docs are live on http://docs.openstack.org/ \o/ Thank you to our release managers, Olena and Alex, who have put in the hard yards over the past few weeks to get us in good shape. Thanks also to Andreas and Kato-san, for everything that they do, and to our speciality team leads and cross project liaisons. And thanks to Christian and Matt for the last minute assistance. Of course, every release belongs to all of you who have written, tested, reviewed, updated, triaged, and edited over the last six months. Well done on another successful release :) Don't forget that you can still use "#success" before a message in any OpenStack IRC channel to call out wins, they are gathered here: https://wiki.openstack.org/wiki/Successes == Progress towards Newton == Newton has been released unto the world. We fixed 479 bugs this cycle, and completed 15 blueprints. We'll begin planning for Ocata over the next couple of weeks, culminating in the Barcelona Summit 25-28 October, where we'll develop our Ocata deliverables list. Stay tuned! == The Road to Barcelona == Our docs schedule is now available here: https://www.openstack.org/summit/barcelona-2016/summit-schedule/global-search?t=Documentation%3A We are also hoping to have a docs session in the Ops track. I'll get back to you with more information on that as soon as I have it. I've requested a docs track at the PTG in Atlanta next February, which will be used for Ocata review and Pike planning. Please let me know if you intend to participate. == Core Team Reviews == Just a quick note that we won't be holding a core team review in November, as it conflicts with Summit. We'll resume these in December for the Ocata cycle. == Doc team meeting == We will take a short break and resume the normal meeting schedule after Summit. In the meantime, you can catch most of us in #openstack-doc in a variety of timezones, so feel free to drop in and ask questions any time. -- Keep on doc'ing! Lana https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#7_October_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?
Thanks for the offer. The scope of the work is probably not huge, based on what we know from the Install Guide. We should be able to more or less copy what we did there. However, I want to collect data based on that experience before we begin, rather than barrelling on down that road. Additionally, I don't feel as though the Install Guide is absolutely complete until we've got the index page done. As I said earlier, there is also the consideration of the short release cycle for Ocata. One point I will make, though, that is with a Pike schedule, you would have Admin Guides up under this model by the Pike release date (about twelve months from now). We planned the Install Guides at the Austin summit, and have published them with Newton. Why the rush? Lana On 08/10/16 02:13, Jay Faulkner wrote: > I'm not necessarily just asking for it to be done -- I'm curious what the > scope of work is because I'm potentially willing to help (and find folks to > help) get it done sooner. If the docs team does not support the admin guide > in-tree until Pike, It'll be Q or later before other projects can utilize it. > That's over a year from today, and I'd rather not have to wait that long to > get a better admin guide up for Ironic. > > Thanks, > Jay Faulkner > OSIC > >> On Oct 6, 2016, at 8:04 PM, Lana Brindley wrote: >> >> (Adding the dev list to cc, as I think this conversation deserves a wider >> audience) >> >> Thanks for this feedback. I'm really glad that the new Install Guide model >> is working out well for people! >> >> Since our new Install Guides have only just been published, at this stage >> I'm intending to gather some data on how projects and users are using the >> project-specific Install Guides during the next cycle. I'm also intending to >> spend some time in the Ocata cycle on improving that index page. It's pretty >> ugly right now, and I think there's some serious UX improvements to be >> done. Since Ocata is a short cycle, I'm also conscious of how much the docs >> team might realistically be able to achieve. >> >> All that said, you are certainly not the first to ask if this model can be >> extended! I think it's something that the docs community would like to see, >> and it seems as though it has broad support amongst developers and projects >> as well. So, in short, I think this is a thing that will happen, but >> probably not in Ocata. I'm tentatively willing to tell you that Pike is a >> possibility though ;) >> >> Lana >> >> On 07/10/16 12:43, Steve Martinelli wrote: >>> FWIW, the keystone team would also be interested in this model >>> >>> On Thu, Oct 6, 2016 at 11:40 AM, Jay Faulkner >> <mailto:j...@jvf.cc>> wrote: >>> >>>Hi all, >>> >>>For those of you who don't know me, I'm Jay Faulkner and I work on >>> Ironic as the Docs liaison as one of my hats. >>> >>>Ironic launched our install-guide right after newton closed, and >>> backported it, thanks to the changes to make the install-guide available in >>> tree. We're a huge fan of this model, and I'm curious if there's any plans >>> to make this happen for the admin-guide. If not, can someone help me >>> understand the scope of work, presuming it's something that the docs group >>> is interested in. >>> >>>If we can get the technical infrastructure in place to do admin-guide in >>> tree, I'd expect Ironic to quickly adopt it, like we did for the install >>> guide. >>> >>>Thanks, >>>Jay Faulkner >>>OSIC >>> >>> >>> ___ >>>OpenStack-docs mailing list >>>openstack-d...@lists.openstack.org >>> <mailto:openstack-d...@lists.openstack.org> >>>http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs >>> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs> >>> >>> >>> >>> >>> ___ >>> OpenStack-docs mailing list >>> openstack-d...@lists.openstack.org >>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs >>> >> >> -- >> Lana Brindley >> Technical Writer >> Rackspace Cloud Builders Australia >> http://lanabrindley.com >> >> ___ >> OpenStack-docs mailing list >> openstack-d...@lists.openstack.org >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?
On 10/10/16 09:37, Steve Martinelli wrote: > On Oct 9, 2016 6:57 PM, "Lana Brindley" <mailto:openst...@lanabrindley.com>> wrote: >> >> Why the rush? > > I think its more eagerness than rush. Project teams made a lot of head way > with the API ref and install guides being in-tree that they want to keep the > momentum with the admin guide. > That makes sense, and I really appreciate the enthusiasm. I'll take these concerns to the Summit, and if the docs team decide that we need to take advantage of that and push ahead in the Ocata cycle, then I'll go with it. Lana -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [OpenStack-docs] Admin guide in-tree?
On 10/10/16 16:25, Andreas Jaeger wrote: > On 2016-10-10 01:37, Steve Martinelli wrote: >> On Oct 9, 2016 6:57 PM, "Lana Brindley" > <mailto:openst...@lanabrindley.com>> wrote: >>> >>> Why the rush? >> >> I think its more eagerness than rush. Project teams made a lot of head >> way with the API ref and install guides being in-tree that they want to >> keep the momentum with the admin guide. > > Those teams are more than welcome to contribute today to the > openstack-manuals repository! Is there anything we can help these? > > Andreas > Yes, Andreas makes a good point. If there's content you want in the guides now, we can help you with that. Lana -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [OpenStack-docs] [ironic] Admin guide in-tree?
Hi Jay, I think that's a perfectly reasonable solution for the moment, and hopefully we'll have the new solution up and running as soon as possible. Please let us know if there's anything you could use a hand with. Lana On 12/10/16 09:00, Jay Faulkner wrote: > We are eager to improve our documentation, but I think quite a few of us who > work on Ironic documentation have a strong preference to keeping those > documents in-tree. This allows us to enforce contributors having > documentation changes or additions merge at the same time or in close > proximity to the code changes and is much easier for us to interact with. I > have the willingness to help implement admin guides in-tree sooner, but if > the docs team doesn't want this yet obviously there's nothing to help with. > > As for what to do today today; I agree with Ruby on this entirely. I'm adding > an item to Monday's Ironic meeting agenda to reach consensus on what our > project will do in the meantime. My recommendation will be option B as listed > by Ruby; build out a better admin-guide in tree as part of our developer > docs, and migrate them over, just like we did for the install guide, when the > work to allow in-tree admin guides is complete. > > Thanks, > Jay Faulkner > >> On Oct 11, 2016, at 9:38 AM, Ruby Loo > <mailto:opensr...@gmail.com>> wrote: >> >> From my point of view, the rush is so that we can be more efficient with all >> of our time/efforts. In ironic, we have a bit of a mess. We now have >> duplicated (and perhaps out-of-sync) admin-related information in our >> developer docs [1] as well as in the official admin guide [2] -- the latter >> content was added but I am unaware of that knowledge/coordination being done >> with the ironic community :-( >> >> Should we : >> A. move our admin-related information from our developer docs to the >> existing admin guide; then move the admin guide to the new in-tree solution >> later >> >> B. replace what is in the existing admin guide with a pointer to the >> developer docs; then move the admin content to the new in-tree solution later >> >> C. status quo until the new in-tree solution is available >> >> --ruby >> >> [1] http://docs.openstack.org/developer/ironic/ >> [2] http://docs.openstack.org/admin-guide/baremetal.html >> >> >> On Mon, Oct 10, 2016 at 7:07 PM, Lana Brindley > <mailto:openst...@lanabrindley.com>> wrote: >> >> On 10/10/16 16:25, Andreas Jaeger wrote: >> > On 2016-10-10 01:37, Steve Martinelli wrote: >> >> On Oct 9, 2016 6:57 PM, "Lana Brindley" > <mailto:openst...@lanabrindley.com> >> >> <mailto:openst...@lanabrindley.com >> <mailto:openst...@lanabrindley.com>>> wrote: >> >>> >> >>> Why the rush? >> >> >> >> I think its more eagerness than rush. Project teams made a lot of head >> >> way with the API ref and install guides being in-tree that they want >> to >> >> keep the momentum with the admin guide. >> > >> > Those teams are more than welcome to contribute today to the >> > openstack-manuals repository! Is there anything we can help these? >> > >> > Andreas >> > >> >> Yes, Andreas makes a good point. If there's content you want in the >> guides now, we can help you with that. >> >> Lana >> >> -- >> Lana Brindley >> Technical Writer >> Rackspace Cloud Builders Australia >> http://lanabrindley.com <http://lanabrindley.com/> >> >> >> >> __ >> OpenStack Development Mailing List (not for usage questions) >> Unsubscribe: >> openstack-dev-requ...@lists.openstack.org?subject:unsubscribe >> <http://openstack-dev-requ...@lists.openstack.org/?subject:unsubscribe> >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev> >> >> >> __ >> OpenStack Development Mailing List (not for usage questions) >> Unsubscribe: openstack-dev-requ...@lists.openstack.org >> <mailto:openstack-dev-requ...@lists.openstack.org>?subject:unsubscribe >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > __ > 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 > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] [Docs] Changes to docs speciality teams, meetings, and reporting
Hi everyone, There was a long-running and wide-ranging conversation during Summit about community engagement in the docs team, most formally at the 'Social Things' session[1], and culminating in the 'Ocata Planning' session[2] on the last day. I suggest you read those etherpads if you weren't at the sessions. This was a major part of my PTL candidacy platform for Ocata, and I'm excited that we had so much productive conversation, complete with some action items that we can implement immediately. First of all, we have seen a drop off in both docs mailing list traffic and docs meeting conversation over the past twelve months or so, even though contributions have remained steady (for the openstack-manuals repo). This is attributed partially to a much-improved Contributor Guide (meaning we spend less time on answering the same questions over and over), and but it's also apparently because conversation is splintering off into speciality team groups, rather than happening in the wider context of the docs group as a whole. So, while speciality teams are definitely valued and important, especially when it comes to directing and completing specific work items, we have come up with a few smaller changes we can make to try and improve our sense of community: * Speciality team meetings are now going to be restricted to once per month, or on an as-needed basis. * The docs meeting will change to a single Euro/APAC timed meeting, every second week, probably around 2100 UTC (to be confirmed). * I will no longer be asking speciality team leads for a written report for the newsletter. Instead, please attend the docs meeting and report there. If you are not able to attend, you will have the option to provide a written report ahead of time to be presented by a proxy. * The newsletter will go to every second week, timed to be after the docs meeting, and will contain speciality team reports and other updates from that meeting. I would like your feedback on these changes, especially if you didn't get a chance to participate in the conversation at Summit. I will be implementing these changes over the next week or so, and there will be further opportunity for you to express your opinion on these changes as we go. Lana 1: https://etherpad.openstack.org/p/BCN-Docs-Social 2: https://etherpad.openstack.org/p/BCN-Docs-OcataPlanningWG -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [Docs] Changes to docs speciality teams, meetings, and reporting
We now have a new docs meeting time, every second Thursday 2100, starting next week, on 18 November. See you there! L On 04/11/16 11:23, Lana Brindley wrote: > Hi everyone, > > There was a long-running and wide-ranging conversation during Summit about > community engagement in the docs team, most formally at the 'Social Things' > session[1], and culminating in the 'Ocata Planning' session[2] on the last > day. I suggest you read those etherpads if you weren't at the sessions. This > was a major part of my PTL candidacy platform for Ocata, and I'm excited that > we had so much productive conversation, complete with some action items that > we can implement immediately. > > First of all, we have seen a drop off in both docs mailing list traffic and > docs meeting conversation over the past twelve months or so, even though > contributions have remained steady (for the openstack-manuals repo). This is > attributed partially to a much-improved Contributor Guide (meaning we spend > less time on answering the same questions over and over), and but it's also > apparently because conversation is splintering off into speciality team > groups, rather than happening in the wider context of the docs group as a > whole. > > So, while speciality teams are definitely valued and important, especially > when it comes to directing and completing specific work items, we have come > up with a few smaller changes we can make to try and improve our sense of > community: > > * Speciality team meetings are now going to be restricted to once per month, > or on an as-needed basis. > * The docs meeting will change to a single Euro/APAC timed meeting, every > second week, probably around 2100 UTC (to be confirmed). > * I will no longer be asking speciality team leads for a written report for > the newsletter. Instead, please attend the docs meeting and report there. If > you are not able to attend, you will have the option to provide a written > report ahead of time to be presented by a proxy. > * The newsletter will go to every second week, timed to be after the docs > meeting, and will contain speciality team reports and other updates from that > meeting. > > I would like your feedback on these changes, especially if you didn't get a > chance to participate in the conversation at Summit. > > I will be implementing these changes over the next week or so, and there will > be further opportunity for you to express your opinion on these changes as > we go. > > Lana > > 1: https://etherpad.openstack.org/p/BCN-Docs-Social > 2: https://etherpad.openstack.org/p/BCN-Docs-OcataPlanningWG > -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 18 November
Hi everyone, Welcome to Ocata! It was great to catch up with many of you in Barcelona, and always refreshing to see the energy around our little project and catch that enthusiasm all over again :) Of course, Ocata is a *very* short cycle, so we've deliberately cut down our deliverables list to ensure we can squeeze it all in. We have two main priorities this release: tidying up the new Install Guides index page, and a little bit of navel gazing in terms of social structures and procedures. More on that in this newsletter! == Progress towards Ocata == 96 days to go! Closed 77 bugs so far. Release tasks are being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDeliverables == The Road to PTG in Atlanta == Event info is available here: http://www.openstack.org/ptg Purchase tickets here: https://pikeptg.eventbrite.com/ Docs is a horizontal project, so our sessions will run across the Monday and Tuesday of the event. == Specs on review == * Ops/Arch Guides: https://review.openstack.org/#/c/392372/ [arch-design] Revise the Architecture Design Guide https://review.openstack.org/#/c/394261/ [ops-guide] Add project upgrade notes https://review.openstack.org/#/c/391786/ Proposed use case form * Training Labs: https://review.openstack.org/#/c/391548/ training-labs: Rewrite training-labs in python == Speciality Team Reports == We've made some structural changes to how Speciality Teams and our regular docs meeting work. Speciality teams will now meet no more than once monthly (most on an 'as needed' basis), and participants are instead encouraged to attend the main docs meeting to discuss work and report on progress. This is aiming to keep all the information about the work we're doing a little more centralised, and give newcomers a way to find out where they can best help. It also gives us a chance to find out where we can help each other, without going to a dozen meetings! * API: Anne Gentle Karen Bradshaw has been working on updates to the openstackdocstheme that would fix this bug: https://launchpad.net/bugs/1583623. The review is up at https://review.openstack.org/#/c/393890/ and getting input from the affected teams who have recognized the need because of errors building when you have multiple API versions with very similar calls, so you end up with identical headings. Launchpad bug 1583623 in openstack-doc-tools "os-api-ref: duplicate labels for selectors" [Low,In progress] - Assigned to Karen Bradshaw (kbhawkey) I've had a couple of inquiries on IRC about "where did the draft/swagger files go?" but to meet their stated end goals, those particular files wouldn't have worked any way due to inaccuracies in the content and incomplete content. See the 100 api-ref doc patches up for review at: https://review.openstack.org/#/q/status:open+file:api-ref. * Configuration Reference and CLI Reference: Tomoyuki Kato No report this week * High Availability Guide: Andrew Beekhof No report this week * Hypervisor Tuning Guide: Joe Topjian No report this week * Installation guides: Lana Brindley No major updates to the guides themselves, but we are planning updates to the landing page. We're also working on getting our first deployment guide landed there, with OpenStack Ansible. I've requested design resources from foundation, but haven't heard back yet, so if you have ideas/suggestions (or design skillz!) then please let me know. * Networking Guide: John Davidge A couple of new articles are close to merging: https://review.openstack.org/#/c/361776/ - VLAN Trunking and https://review.openstack.org/#/c/356013/ - Routed Provider Networks. Need to decide how best to track the work that's going on for https://blueprints.launchpad.net/openstack-manuals/+spec/use-openstack-command. Probably a google spreadsheet or etherpad with a list of all the network guide pages to be converted, and the person working on it would be best. That way we can hopefully avoid duplicating efforts. * Operations and Architecture Design guides: Darren Chan We're slowly making progress with the arch guide, and have cloudnull onboard to help. So the focus is completing the design chapter and migrating stuff from the ops guide. * Security Guide: Nathaniel Dillon No update this week. * Training Guides: Matjaz Pancur We changed our IRC meeting to every two weeks (on even weeks) on Tuesday at 1300 UTC in #openstack-meeting-3. There will be an article published about BCN Upstream training in OpenStack's Superuser magazine. BCN Upstream training retrospective https://etherpad.openstack.org/p/upstream-training-barcelona-retrospective * Training labs: Pranav Salunke, Roger Luethi We have the python port already under review, the spec is not done yet, but we hope to get them merged soonish and in the right order :) User guides: Joseph Robinson * This the current work on converti
Re: [openstack-dev] [OpenStack-docs] [osa] [docs] OpenStack-Ansible deploy guide live!
On 01/12/16 01:03, Alexandra Settle wrote: > Hi everyone, > > > > I am really pleased to announce that the OpenStack-Ansible Deployment Guide > is now available on the docs.o.o website! You can view it in all its glory > here: http://docs.openstack.org/project-deploy-guide/newton/ > > > > This now paves the way for many other deployment projects to publish their > deployment guides on the docs.o.o website, under “Deployment Guides” > <http://docs.openstack.org/> and gain more visibility. > > Nice work! :) L -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? Holiday Edition!
Hi everyone, The end of the year is nearly upon us already, and this will be my last newsletter for 2016, before I disappear for the holidays on the 16th. I've had yet another wonderful year with all you lovely OpenStack people, and I wish all of you and your families a happy and safe holiday, wherever and however you celebrate it. Here in Australia, the temperature is starting to soar, so I'm off on another cruise, followed by a few lazy days by the pool with family and friends. I'll be back in the office early in the new year, and ready to kick Ocata out of the door! As many of you already know, I'm not planning on running for Pike PTL. If you're interested in running for PTL (for Pike or any future release), and would like a crash course in PTLing, please let me know and I can share whatever meagre wisdom I've gleaned before self nominations open in mid-January. == Progress towards Ocata == 82 days to go! Closed 106 bugs so far. Release tasks are being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDeliverables == The Road to PTG in Atlanta == Event info is available here: http://www.openstack.org/ptg Purchase tickets here: https://pikeptg.eventbrite.com/ Docs is a horizontal project, so our sessions will run across the Monday and Tuesday of the event. The incoming PTL will be responsible for planning and running sessions at the Atlanta PTG. == Speciality Team Reports == * API: Anne Gentle The App Dev Support WG is working on a survey to determine which content areas to invest in for content on http://www.openstack.org/appdev (http://lists.openstack.org/pipermail/user-committee/2016-November/001469.html) * Configuration Reference and CLI Reference: Tomoyuki Kato We try to recreating the single page view for the "openstack" command. I'd like to generate the reference from source code automatically. However, python-openstackclient has many plug-ins. It is difficulty, but worth to tackle it. We need your help! * High Availability Guide: Andrew Beekhof No formal report, but Alex Settle has been doing a lot of work on this guide recently, cleaning up, and raising bugs for some of the TODO items. We need to consider if the HA guide is an ongoing concern. Ben Silverman is wondering if we can fold the content into the Ops/Arch Guides. This will be raised on the mailing list for more conversation. * Hypervisor Tuning Guide: Joe Topjian No report this week * Installation guides: Lana Brindley We've heard back from Foundation on design resources, I'm going to reply to that email today and hopefully start drafting the new design next week. I've also got Piet from the UX team on board to help. Anyone who wants to be involved with that, please contact me. * Networking Guide: John Davidge No update this week. * Operations and Architecture Design guides: Darren Chan For the Arch guide, patches for networking and compute content were merged, thanks to Ben and Shaun. For the Ops Guide, there is patch up to update the upgrades chapter and include links to the project upgrade notes: https://review.openstack.org/#/c/404528/ * Security Guide: Nathaniel Dillon No update this week. * Training Guides: Matjaz Pancur BCN Upstream training article in the Superuser magazine: http://superuser.openstack.org/articles/openstack-upstream-training-revamp/ - actively looking for contributors to join the Upstream training, please see http://lists.openstack.org/pipermail/openstack-docs/2016-November/009382.html - cleaned test entries in the Launchpad bug queue and the Sandbox repository (left from the Barcelona Upstream training) - updated Training guides README.rst * Training labs: Pranav Salunke, Roger Luethi No update this week. * User guides: Joseph Robinson The legacy command conversion continues at a good pace. I have some more updates to patch today. The only obstacle I have run into is generating new output to match the OpenStack command client. Otherwise, contributors have been adding to the table, and there's been steady patching completed. Just a reminder to update the table if making a change: https://wiki.openstack.org/wiki/Documentation/ReorganizeUserGuides == Doc team meeting == Our next meeting will be on Thursday 16 December at 2100 UTC in #openstack-meeting-alt For more meeting details, including minutes and the agenda: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting -- Keep on doc'ing! Lana https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#1_December_2016 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
Re: [openstack-dev] [docs] Stepping down from core
On 22/12/16 02:11, Matt Kassawara wrote: > Howdy! > > After several years of contributing to OpenStack documentation, a significant > change in my career path warrants resigning from my role as a core reviewer. > Working with the OpenStack community was a great experience and I hope it > continues to grow... with sufficient documentation, of course. > > Cheers, > Matt > Thanks for all your dedication and hard work over many years, Matt. Without you (and Tom!) I would never have gotten my first docs patch in, so I owe you a lot :) All the best for the next step in your big adventure. Lana -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
[openstack-dev] What's Up, Doc? 13 January
Hi everyone, Welcome to 2017. I hope you all had a chance to rest up a little before we hurtle straight into another release, as Ocata is now only 40 days away! I'll be in contact with our lovely release managers Brian and Mariia over the next week or so to kick off release management tasks. We will need people to test the Installation Guide again, too, so if you're interested in helping out there, please let me know. As many of you already know, I'm not planning on running for Pike PTL. PTL nominations open in the week of 23 January, and I'll be working with Alex and Kato-san who have both expressed interest in taking on this role. If you're interested in running for PTL (for Pike or any future release), and would like a crash course in PTLing, please let me know and I can share whatever meagre wisdom I've gleaned. == Progress towards Ocata == 40 days to go! Closed 149 bugs so far. Deliverables are being tracked here: https://wiki.openstack.org/wiki/Documentation/OcataDeliverables == The Road to PTG in Atlanta == Event info is available here: http://www.openstack.org/ptg Purchase tickets here: https://pikeptg.eventbrite.com/ Docs is a horizontal project, so our sessions will run across the Monday and Tuesday of the event. We will be combining the docs event with i18n, so translators and docs people will all be in the room together. The incoming PTL will be responsible for planning and running sessions at the Atlanta PTG. Also, a quick note that the CFP and ticket sales for *Boston* in May are now open: https://www.openstack.org/summit/boston-2017/call-for-presentations/ == Speciality Team Reports == * API: Anne Gentle Fairy-slipper is being retired. It was a good tool, served its purpose, and can now traipse into the sunset, thanks to AJaeger and stevemar for the help with the patches. Be sure to follow the service catalog naming conventions work going on in the API WG. And there's also a new EC2 API reference: http://developer.openstack.org/api-ref/ec2-api/ * Configuration Reference and CLI Reference: Tomoyuki Kato Config Reference: Updated a few plug-ins. CLI reference: Updated a few command references and removed unsupported Block Storage API v1 and Image API v1. * High Availability Guide: Andrew Beekhof No report this week * Hypervisor Tuning Guide: Joe Topjian No report this week * Installation guides: Lana Brindley Testing for Ocata will be opening soon. Also, we need a web dev for the landing page, if you know of anyone, please get me in touch. * Networking Guide: John Davidge No update this week. * Operations and Architecture Design guides: Darren Chan Ben Silverman has spent some time refining the Compute content in the Arch Guide draft. Thanks Ben! We are also looking for more SMEs to help with the Arch Guide. So if you're interested, contact asettle or me. * Security Guide: Nathaniel Dillon No update this week. * Training Guides: Matjaz Pancur No update this week. * Training labs: Pranav Salunke, Roger Luethi No update this week. * User guides: Joseph Robinson The command conversions have happened at a good pace, the User Guide appears to be mostly complete, with the condition that the trove and manila teams do not have OpenStack commands yet. I have started checking through the Admin Guide files. I suspect there is more to convert, but it should be ready for Ocata. == Doc team meeting == Our next meeting will be on Thursday 27 January at 2100 UTC in #openstack-meeting-alt For more meeting details, including minutes and the agenda: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting -- Keep on doc'ing! Lana https://wiki.openstack.org/wiki/Documentation/WhatsUpDoc#13_January_2017 -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com signature.asc Description: OpenPGP digital signature __ 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
