13:00:56 #startmeeting docteam 13:00:57 Meeting started Wed Jun 17 13:00:56 2015 UTC and is due to finish in 60 minutes. The chair is ShillaSaebi. Information about MeetBot at http://wiki.debian.org/MeetBot. 13:00:58 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 13:01:00 The meeting name has been set to 'docteam' 13:01:11 roll call...anyone here? 13:01:16 Hi 13:01:26 hi katomo 13:01:58 o/ 13:02:04 hi Rob 13:02:39 ok lets go ahead and get started, looks like its just the 3 of us for now 13:02:42 Hi there. Took over from the previous Horizon liason at the summit, excited to help out. 13:02:52 awesome!!! great news Rob! 13:03:11 #topic Action Items 13:03:25 lets go over the action items from the last meeting 13:03:50 Liberty specs in review #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z 13:04:45 #topic Reviews in progress 13:04:50 Hi Scott!! 13:05:05 Good morning :) 13:05:38 #link https://review.openstack.org/191074 (Debian Install Guide) 13:05:50 #link https://review.openstack.org/#/c/191041/ (Driver docs - requires discussion) 13:05:58 #link https://review.openstack.org/#/c/191520/ (Install Guide RST conversion) 13:06:07 #link https://review.openstack.org/#/c/191077/ (Install Guide Liberty update) 13:06:15 #link https://review.openstack.org/#/c/177934/ (API work) 13:08:37 sorry got disconnected 13:08:50 yes so if you guys can take a look at those links and review, it would be very helpful 13:08:58 any questions? 13:09:21 alrighty moving along 13:09:29 #topic Specialty teams 13:09:30 not yet. 13:09:39 #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams 13:09:48 this is the page that lists all the documentation specialty teams 13:10:20 there are 8 of them and if you want to contribute to a certain section, you can see their wiki page and get more details 13:10:50 #info HA Guide - RST migration is currently underway 13:11:04 #link https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide 13:11:29 its my understanding that when making a change towards the HA guide, you should make the change with the XML and the RST for now 13:11:40 since the conversion is in progress 13:12:08 #info Install Guides - the specs are now up for review 13:12:21 #link https://review.openstack.org/#/c/191077/ (Liberty update) 13:12:29 and the install guide RST conversion is also underway 13:13:04 #info Networking Guide - this is in the test & review phase. The blueprint/specs are to be created for the Liberty work soon. 13:13:32 #info Security Guide - RST conversion is in currently in the planning phase 13:14:00 #info User Guides - The cloud admin guide RST conversion is now underway and in progress 13:14:17 #link https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Migration 13:14:22 Hi Pratap! 13:14:31 Good morning Shilla 13:14:46 apologies for the delay in joining 13:14:48 Are there links on RST or how to convert anywhere? 13:14:56 Or is it recommneded to just dive in. 13:15:08 I would say dive in but also reach out to the ML 13:15:14 the docs ML 13:15:24 ok 13:15:30 Probably can search the archives too. 13:15:36 We can schedule some time to go over it because I'm sure that's where we will be heading with the ops guide 13:15:43 Exactly. 13:15:44 which leads me to the next specialty team 13:15:44 :) 13:15:49 #info Ops/Arch Guides - This is a new speciality team that was just formed last week!!! 13:15:58 first meeting will be later this week 13:16:15 and we were looking for volunteers, we seem to have a good amount but feel free to join in 13:16:17 !!! 13:16:18 katomo: Error: "!!" is not a valid command. 13:16:23 #link https://wiki.openstack.org/wiki/Documentation/OpsGuide 13:16:44 Hi MeganR! 13:16:47 I want to join ops guide. 13:17:10 katomo see the link above? feel free to sign up via the wiki page 13:17:22 Good morning 13:17:22 got it. 13:17:28 The whole guide is in XML, I'm sure we will work on migrating to RST 13:17:40 lots of copy/editing to do as well 13:17:42 thanks. 13:17:48 Sounds mind-numbingly nice :) 13:17:51 also need to update the content to match the newer releases 13:18:05 looking forward to it and thank you Katomo 13:18:18 #info API docs - If you have time please review the spec #link https://review.openstack.org/#/c/177934/ 13:18:51 #info Config Ref - Another new speciality team and thanks to Guavain for organizing it (I don't think he's here right now) 13:19:04 #link https://wiki.openstack.org/wiki/Documentation/ConfigRef 13:19:45 Interesting... 13:19:53 looks like as of now there are only 4 members on the team 13:20:02 another good opportunity to sign up and help out 13:20:33 hmmm 13:20:34 especially operators and sys admins :) 13:21:02 so those are all the updates I have for the specialty teams, hopefully will have more next week 13:21:02 Agreed 13:21:08 especially once the 2 new teams kick off 13:21:35 any questions/concerns or comments? 13:21:59 alright 13:22:12 #topic Doc tools update 13:22:34 I have no news or updates for this 13:23:31 #topic Liaisons 13:24:06 just a heads up that we have lovely documentation liaisons: #link https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation 13:24:50 these are our SMEs so if you need clarification on a subject you are writing about or any assistance what so ever, you can always reach out to them 13:24:56 That's handy 13:25:11 yes, they can help with specialty information related to certain projects 13:25:28 so if we need clarification on something, it is very helpful 13:25:49 we have one of our very own liaisons in this meeting now 13:25:51 thanks Rob! 13:26:39 #topic APAC Meetups 13:27:03 :) 13:27:09 There are plans for an APAC OpenStack meet up in June, if you need any more information on it ping asettle & adahms 13:27:33 I know we're already in the middle of June but I'm not sure what dates 13:27:38 I know it hasn't already happened yet 13:27:49 :-) 13:28:15 Also there are plans for an APAC Docs Swarm on 13-14 August 13:28:26 if you need anymore information on it ping Suyog 13:28:55 #topic Ironic Docs 13:29:36 pshige here? 13:29:59 Lana has been in touch with the ironic documentation team, and they're looking for some writing assistance on the ironic Installation Guide. In this case, some copy editing, and perhaps an architecture review, are required. 13:30:14 I was able to get some work done on the install guide, I have a review out 13:30:22 its mainly copy editing work and formatting 13:30:49 #link https://review.openstack.org/#/c/191900/ 13:30:55 feel free to review it 13:31:33 Gauvain and Nick are also going to be working on this. If you want to help and need more details, please ping Lana or send her an e-mail 13:32:09 This is something we're doing as an alternative to bringing the guide into our repo. The docs will remain in the ironic repo which means the ironic dev team is responsible for the ongoing maintenance of the docs. 13:32:51 o.k. 13:33:22 any questions about that? 13:33:38 none 13:34:04 #topic Spotlight bugs 13:34:22 #link https://bugs.launchpad.net/openstack-manuals/+bug/1195875 Controller Callbacks 13:34:23 Launchpad bug 1195875 in openstack-manuals " Controller Callbacks" [Medium,Invalid] 13:34:41 #link https://bugs.launchpad.net/openstack-manuals/+bug/1201978 Pluggable Remote User 13:34:42 Launchpad bug 1201978 in openstack-manuals " Pluggable Remote User" [Medium,Confirmed] 13:34:50 #link https://bugs.launchpad.net/openstack-manuals/+bug/1204566 Stop and delete operations 13:34:51 Launchpad bug 1204566 in openstack-manuals " Stop and delete operations should give guest a chance to shutdown" [Medium,Confirmed] - Assigned to Olga Gusarenko (ogusarenko) 13:36:14 if those can get some attention, that would be great 13:36:50 thats all i got folks 13:36:55 #topic Open Discussion 13:37:03 anything anyone wants to bring up or talk about/discuss>? 13:37:24 I don't have anything. 13:37:32 none 13:37:35 I had a question 13:37:40 sure 13:38:04 w/ regards to out of repo docs, like Horizon, and Ironic it seems, whats is the review process? 13:38:19 Should I be asking for docs cores to look over before merging into Horizon etc 13:38:25 you can 13:38:35 i have made changes to the dev docs in sahara, ironic, horizon, cinder 13:38:58 I find that every project has been very appreciative of any doc changes we put in 13:39:24 I have had to pull in a core before to discuss formatting, or stuff the project team was unclear about 13:39:31 a doc core that is 13:39:54 I would say work on it and then you can post the links during the meetings or send to the ML if it's not making any traction 13:39:57 Awesome. I have some work coming along, so should I just use the mailer to ask for reviews, or is IRC preferred? 13:40:17 either is fine, probably ML since not everyone is watching IRC 13:40:29 Sure thing. Thanks. 13:40:39 anytime! 13:41:13 any other questions? 13:41:37 Hi, the calendar schedule suggests the doc team meeting starts in 19 mins.. Is it wrong? 13:42:13 Hi Daviey, yes the meeting started at 9:00 AM ET (1:00 PM UTC) 13:42:28 which calendar did you look at? 13:42:51 http://eavesdrop.openstack.org/#Documentation_Team_Meeting 13:42:55 (and the generated ical) 13:43:38 wow you are right about that 13:43:42 it says 1400 UTC 13:43:48 https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting 13:43:52 I will talk to Lana and have her modify it 13:44:32 great 13:44:36 thanks 13:44:48 in the meantime you can get the details for today from: https://wiki.openstack.org/wiki/Documentation/MeetingLogs 13:44:53 once I do the logging at the end 13:44:58 sorry about that Daviey 13:45:03 Ill make sure to send an email to Lana immediately 13:45:14 no problem, thanks 13:45:23 I changed the wiki 13:45:30 The other page I'm not sure how 13:45:51 :) 13:45:59 thanks rob 13:46:25 The IRC meetings schedule is driven by the openstack-infra/irc-meetings repository apparently 13:46:39 Yeah, just putting up a patch 13:46:56 yeah ok we can get it modified 13:47:21 ok anything else anyone wants to bring up? 13:47:53 nothing 13:48:09 alright I guess we can go ahead and call it. Thank you everyone for joining! 13:48:22 thank you 13:48:27 #endmeeting 13:48:51 Thanks, see you. 13:49:30 Thanks everyone 13:50:09 #endmeeting 14:00:24 hello 14:01:34 ShillaSaebi_: hello? 14:01:57 hi 14:54:50 #endmeeting