21:00:48 <jrobinson> #startmeeting docteam
21:00:49 <openstack> Meeting started Thu Apr  6 21:00:48 2017 UTC and is due to finish in 60 minutes.  The chair is jrobinson. Information about MeetBot at http://wiki.debian.org/MeetBot.
21:00:50 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote.
21:00:52 <openstack> The meeting name has been set to 'docteam'
21:01:07 <jrobinson> We'll start with a roll call.
21:01:14 <jrobinson> Who is around for the meeting today?
21:01:37 <ianychoi> o/
21:01:44 <skelso> o/
21:02:10 <Mutter> Hi psargent is here... New to the doc team
21:02:48 <ianychoi> skelso, hi :) Mutter hello!
21:02:48 <jrobinson> ianychoi, skelso o/
21:03:05 <jrobinson> Mutter, welcome to the meeting :)
21:03:11 <ianychoi> jrobinson, :)
21:03:17 <skelso> Hi ianchoi
21:03:22 <bmoss> howdy
21:03:31 <jrobinson> bmoss, o/
21:03:40 <ianychoi> bmoss, good morning!
21:04:21 <Mutter> Hello
21:04:25 <bmoss> good morning all!
21:06:22 <jrobinson> I suspect other attendees might arrive with updates similar to last meeting, so I'll continue with the agenda.
21:06:58 <darrenc> o/
21:07:20 <jrobinson> First of all, I'll just briefly mention Alex (asettle) was unable to host the meeting today, but has a written several items on the agenda.
21:07:26 <jrobinson> darrenc, \o
21:07:27 <psargent> Hello, this is my first meeting
21:07:40 <darrenc> welcome psargent!
21:07:54 <psargent> Thank you!
21:08:34 <jrobinson> psargent, If you're not familiar with IRC meetings, there will be conversation topics tied to the agenda, which you can see here:
21:08:39 <jrobinson> https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting
21:08:58 <psargent> Ok, got it, thanks
21:09:00 <jrobinson> I'll start with the first item
21:09:12 <jrobinson> #topci Action items from the last meeting
21:09:16 <jrobinson> #topic Action items from the last meeting
21:09:44 <jrobinson> Since we didn't have any to action, moving on to the next topic
21:09:58 <jrobinson> #topic Countdown to summit - Boston
21:10:22 <jrobinson> This is mainly an update on some specific sessions taking place at Boston.
21:10:47 <jrobinson> A reminder that docs and I18n have project onboarding sessions.
21:11:19 <jrobinson> And a new update - There will be a User Committee forum topic on finding Ops Guide feedback
21:11:41 <jrobinson> This will be carried by Melvin Hillsman (mrhillsman - irc)
21:11:56 <jrobinson> Forums are a new part of the conference
21:12:00 <jrobinson> #link https://wiki.openstack.org/wiki/Forum
21:12:49 <jrobinson> #Info "the entire OpenStack community (users and developers) gathers to brainstorm the requirements for the next release, gather feedback on the past version, and have strategic discussions that go beyond just one release cycle."
21:14:06 <jrobinson> There will also be a topic on developer.openstack.org, which David Flanders from the OpenStack foundation will speak on.
21:14:48 <jrobinson> These two sessions are relevant to us for our Operator Docs, and because the developer.o.o houses our API, SDK, and other dev related docs.
21:16:08 <jrobinson> #Info Alex has asked that if you have any feedback or questions about the forum topics on the Ops Guide, or developer.o.o to please contact her.
21:16:31 <jrobinson> Alex's main objective is to find places to reduce technical debt for docs housed on developer.o.o
21:16:47 <jrobinson> Again, the Summit Schedule is available:
21:16:55 <jrobinson> #link https://www.openstack.org/summit/boston-2017/summit-schedule/
21:17:03 <jrobinson> Any questions on this at the moment?
21:18:26 <ianychoi> Nope now
21:18:28 <bsilverman_10> no
21:18:58 <jrobinson> If anything comes up, you can let Alex know.
21:19:08 <jrobinson> Next topic:
21:19:18 <jrobinson> #topic PTL report
21:19:49 <jrobinson> "I (asettle) still in the process of drafting a governance tag for our guides called "docs:follows-policy". I have been working with Doug Hellmann (dhellmann) in the last week to change to draft dramatically, so it would be good for docs people to review again."
21:20:30 <jrobinson> The new governance tag patch reviews continued:
21:20:33 <jrobinson> "We are trying to make this a more broad tag now, so it can be applied for other guides too."
21:21:00 <jrobinson> #link https://review.openstack.org/#/c/445536/
21:21:19 <dhellmann> I just RC+1 that draft, and from my perspective it's ready for the docs team to sign off. We'll likely need to land the contrib guide detail patch before the governance patch, so reviewing that would help, too.
21:21:42 <jrobinson> Thank you dhellmann
21:21:59 <dhellmann> #link https://review.openstack.org/453642
21:22:34 <jrobinson> It is in need of reviews or feedback.
21:22:58 <jrobinson> Alex is also working on contributor guide instructions on how the tag will be used
21:23:11 <jrobinson> This is the second link dhellmann shared^
21:23:35 <jrobinson> Again please review when you can.
21:23:57 <dhellmann> to make this go smoothly, it's important to land *something* and iterate on the details, so keep that in mind when reviewing the contrib guide doc
21:24:33 <ianychoi> dhellmann, oh.. contributor guide.. good point - it would be a good reference how to make use of the tag and also how to request another tag in openstack/governance thanks :)
21:24:38 <dhellmann> we wouldn't want subsequent updates to be drastically different, but if there are small changes or details to add, this will all go faster if those happen as follow-ups instead of requiring new revisions of the contrib guide change
21:25:00 <dhellmann> ianychoi : yes, we're trying to put as much of the detail as possible there, where it is easy for the team to manage, and won't require TC approval
21:25:06 <jrobinson> This is true, we can always make word choice adjustments in follow up patches after the main content - improving what we have - merges.
21:25:14 <dhellmann> jrobinson : right
21:25:55 <ianychoi> +1 :)
21:27:06 <jrobinson> Any further questions or thoughts on the governance tag?
21:28:17 <jrobinson> Okay, next topic on the list
21:28:40 <jrobinson> #topic Speciality teams reports
21:29:00 <jrobinson> API - annegentle is there an update on the API docs?
21:29:23 <annegentle> jrobinson hi, all I had for this week I sent to the list
21:29:43 <annegentle> #link  http://lists.openstack.org/pipermail/openstack-dev/2017-March/114690.html
21:30:24 <annegentle> In a nutshell, API versioning in relation to release versioning is currently manually compiled for the 40-ish API services
21:30:39 <annegentle> so ideas on how to automate and surface that info welcomed
21:31:30 <jrobinson> thank you annegentle!
21:33:12 <jrobinson> Configuration Reference and CLI Reference : I'm not sure if katomo is here at the moment.
21:34:07 <jrobinson> No new updates on the dev mailing list I can see. Next is HA Guide
21:34:22 <jrobinson> iphutch, any HA guide updates?
21:34:43 <iphutch> we are continuing to collaborate with OS DevOps team
21:35:04 <iphutch> see the tag ha-guide-draft for bugs opened to fill content for the new guide
21:35:17 <iphutch> (in launchpad)
21:36:01 <jrobinson> Thank you iphutch
21:37:18 <jrobinson> Next is Hypervisor Training
21:38:12 <jrobinson> Can't see any updates from Blair on the ML
21:38:35 <jrobinson> Moving on the Installation Guides
21:38:52 <jrobinson> One update from loquacities:
21:39:07 <jrobinson> "We have now branched, so please remember to backport if you have edits to the Ocata guide now. Big thanks to all the testers who have been working hard over the past month or two (that Nova cells bug was *tough*!), and to Brian and Mariia for doing the heavy lifting."
21:39:23 <jrobinson> "Noticed a bunch links to draft versions of the guide in Newton/Ocata branches, backports for that have been merged, and the Contributor Guide updated so we don't miss it in the future (https://docs.openstack.org/contributor guide/release/taskdetail.html#update-links-in-all-books)."
21:41:36 <jrobinson> For the Networking Guide: Could not find any updates from John Davidge
21:41:53 <jrobinson> Moving on to Operations and Architecture Design Guides
21:42:06 <jrobinson> darrenc, any updates on the Arch Design and Ops Guides?
21:42:16 <darrenc> yep
21:42:32 <darrenc> Arch Guide: edited architecture considerations content and cleaned up the index page structure which was applied across OS manuals. Some ops-related content was moved to the Ops Guide
21:42:52 <darrenc> Our current focus is improving the storage design content and networking design content
21:43:14 <bsilverman_10> +1 :slightly_smiling_face:
21:43:24 <darrenc> lol
21:43:55 <jrobinson> Thank you darrenc
21:44:37 <jrobinson> Security Guides: I can't find any updates from Nathaniel Dillon
21:45:23 <jrobinson> Training Guides: Matjaz Pancur
21:45:46 <jrobinson> Apart from an older update on the OpenStack Upstream Institute for training, I can't see any new updates
21:46:10 <jrobinson> Training Labs: Pranav Salunke, Roger Luethi
21:47:01 <jrobinson> The training labs Ocata release became available this week.
21:47:19 <ianychoi> Great :)
21:47:23 <jrobinson> Good news \o/
21:47:48 <jrobinson> Thanks to the training guides team for their work here, despite changing responsibilities.
21:47:58 <jrobinson> Admin and User Guides:
21:47:59 <ianychoi> s/training guides/training labs :)
21:48:25 <jrobinson> Yes! thanks ianychoi, sorry, that was the incorrect team name there.
21:48:45 <ianychoi> jrobinson, fine - sometimes it is confusing :)
21:49:19 <jrobinson> For the user guides - the spec on migrating the Admin Guide content this week moved closer to merging.
21:49:38 <jrobinson> I started preparing the work items for action on the User Guides tasks wiki page.
21:50:05 <jrobinson> I'll find the links in a moment, but moving on
21:50:24 <jrobinson> Docs theme and tools: bmoss any updates ?
21:50:37 <bmoss> - Anne has a spec up for theme consolidation, please check it out: https://review.openstack.org/#/c/454346/
21:50:37 <bmoss> - Brian has fixed up the sitemap tool tests, reviews welcome: https://review.openstack.org/#/c/453976/
21:50:37 <bmoss> - 41 open bugs, 13 closed in Pike
21:51:12 <bmoss> #link https://review.openstack.org/#/c/454346/
21:51:23 <bmoss> #link https://review.openstack.org/#/c/453976/
21:51:54 <bmoss> that's about it from me
21:52:03 <jrobinson> thank you bmoss
21:52:12 <jrobinson> #topic Bug triaging
21:52:24 <jrobinson> "One more volunteer required (14 Aug - 28 Aug) to fill out the schedule for the entire release. Thanks everyone for getting on board."
21:52:30 <jrobinson> #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams#Bug_Triage_Team
21:52:50 <jrobinson> Thanks to Lana for doing a great job this week!
21:52:57 <jrobinson> Lana's report:
21:53:07 <jrobinson> "Overall, went well. Zero new bugs on Wednesday (before I went on PTO). I would like to get some eyeballs on https://bugs.launchpad.net/openstack-manuals/+bug/1676875 (re: Block Storage in the Install Guide), I've got a WIP patch here: https://review.openstack.org/452581 Jay Bryant from cinder is taking a look while Sean McGinnis is on holidays."
21:53:07 <openstack> Launchpad bug 1676875 in openstack-manuals "Update install-guide for block-storage" [Low,In progress] - Assigned to Lana (loquacity)
21:53:26 <jrobinson> Next up - Alex will triage bugs from April 10 to April 24
21:53:31 <jrobinson> #Open Discussion
21:53:36 <jrobinson> #Topic Open Discussion
21:53:50 <jrobinson> There, better. Any topics to discuss openly?
21:54:53 <jrobinson> This is the admin guide spec in review:
21:54:56 <jrobinson> #link https://review.openstack.org/#/c/439122
21:55:21 <jrobinson> As noted earlier, it is closer to merging, with a clear plan moving forward.
21:55:21 <psargent> I am new to the team, please feel free to reach out to me on the list if you have something for newbies to look at
21:55:42 <annegentle> psargent how do you know amrith?
21:56:43 <bsilverman_10> psargent: Do you have an area you are interested in?
21:59:09 <jrobinson> I might close the meeting, and we can continue the discussion on OpenStack doc or the ML.
21:59:36 <jrobinson> Okay, thanks everyone!
21:59:40 <jrobinson> #endmeeting