00:32:09 #startmeeting docteam 00:32:10 Meeting started Wed Jun 10 00:32:09 2015 UTC and is due to finish in 60 minutes. The chair is loquacities. Information about MeetBot at http://wiki.debian.org/MeetBot. 00:32:11 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 00:32:13 The meeting name has been set to 'docteam' 00:32:28 hello documentation lovelies! 00:32:37 hello! 00:32:40 who is here? 00:32:40 o/ hello 00:32:44 hello! 00:32:46 o/ 00:32:56 Morning all! 00:33:01 hey 00:33:13 pshige: welcome! 00:33:26 * loquacities quickly adds ironic docs to the agenda, and hopes no one notices 00:33:31 sunny-dee! great to see you! 00:33:45 :) 00:33:59 loquacities: i'm blushing 00:33:59 what's ironic is that you posted that to the list while expressing the desire that no one notices. 00:34:02 sicarie: hi :) 00:34:06 * sicarie tries to sneak in quietly 00:34:08 bmoss: sssh! 00:34:12 (i think they're on to me!) 00:34:21 sicarie: failed, sorry :P 00:34:27 furface, suyog hello! 00:34:30 that’s about how my day is going 00:34:33 hello! 00:34:33 eh, it's like rain on your wedding day, or free ride when you've already paid. 00:34:34 hey loquacities :) 00:34:35 hi, loquacities! 00:34:59 alrighty, let's get rolling ... 00:35:11 #topic Action items from the last meeting 00:35:31 none from the US meeting 00:35:57 and one for adahms about the APAC openstack meetup 00:36:05 Yep 00:36:06 we might hit that one later on in the agenda, so let's move right along 00:36:22 Roger that 00:36:30 #topic Install and Config Reference have now been branched for Kilo. 00:36:38 #info To backport, commit to master with Backport: Kilo in your commit message. 00:36:45 that shouldn't be news to anyone at this point 00:36:49 any questions on the kilo branch? 00:37:16 #topic core team changes 00:37:23 #info Please welcome our new core Darren Chan, and bid a fond adieu to Summer Long and Bryan Payne 00:37:57 gee, don't all speak at once :P 00:38:05 Woah 00:38:05 Hello Goodbye 00:38:05 Sorry 00:38:06 * darrenc takes a bow 00:38:10 quoth the Beatles 00:38:12 lol 00:38:15 Darren congratulations :) 00:38:16 Welcome darrenc! 00:38:18 YAY darrenc 00:38:21 any beatles quote is ok by me :) 00:38:26 congrats darrenc! 00:38:34 Congrats, darrenc! 00:38:48 thanks! 00:38:49 Congratulations! 00:38:59 #topic Please ensure any bug you work on has been triaged first. This is to prevent unnecessary work. 00:38:59 Summer and Bryan - Sad to see you both go :( your patches and expertise and skills were stellar. 00:39:11 so, this one is just a PSA, really 00:39:31 we've noticed a few patches we had to nuke from orbit just before they gated 00:39:49 so making sure someone else has triaged your bug before you work on it is a Really Good Idea (tm) 00:40:03 if you're desperate to get started, feel free to ping someone in the IRC channel or on the list 00:40:13 there should be a core around in most timezones 00:40:21 any questions on that one? 00:40:26 Could we flag that as info? re: collaborate to get triage and patches moving 00:40:40 JRobinson__: go right ahead :) 00:40:50 anyone can use the info tag, not just me :P 00:41:14 #info Make sure someone else has triaged your bug before work stars. Contact writers in IRC or the list for help 00:41:21 thanks! 00:41:26 ok, that's it for the PSAs 00:41:34 #topic Liberty specs in review 00:41:41 #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z 00:41:48 #link https://review.openstack.org/183138 (Install Guide RST conversion) 00:41:53 #link https://review.openstack.org/#/c/177934/ (API work) 00:42:05 #info there's also a few training specs, that probably need love 00:42:21 any issues or questions on specs in flight? 00:43:00 ok, let's roll over to speciality team updates ... 00:43:04 #topic Specialty teams 00:43:17 #info HA Guide - RST Underway: https://blueprints.launchpad.net/openstack-manuals/+spec/improve-ha-guide 00:43:30 #info Install Guides - Spec now up for review https://review.openstack.org/183138 00:43:39 #info User Guides - Cloud Admin Guide RST conversion now underway 00:43:45 just a note on this 00:43:50 #link https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Guide_Migration 00:43:53 bmoss: go ahead 00:44:15 Sam-I-Am has audited the networking information in the Cloud Admin Guide, and much of it may be taken out. 00:44:30 So for now please focus RST migration efforts on other sections of the guide 00:44:58 cool, thanks bmoss 00:45:10 you should do that as an info, too, so it goes in the minutes ... 00:45:12 #info for the Cloud Admin RST conversion, avoid networking content since the networking content may change soon 00:45:25 JRobinson__ has my back. :) 00:45:26 thanks JRobinson__ :) 00:45:31 he's all over it :P 00:45:35 that's right :) 00:45:39 #info Security Guide - No update, but needs love. Lana to touch base with Nathaniel. 00:45:47 i confess, i haven't done this 00:45:47 Noted (since I was on the networking stuff) 00:45:47 * sicarie waves hello 00:45:53 hi sicarie :) 00:46:00 i'm sorry i haven't emailed you about this yet 00:46:01 That’s why I’m here - I deliver! 00:46:05 no worries 00:46:07 and i'm excited you came! 00:46:15 (makes me look less slack :P ) 00:46:22 hehe 00:46:32 So we have several contributors waiting on the RST migration as well: https://bugs.launchpad.net/openstack-manuals/+bug/1463111 00:46:33 Launchpad bug 1463111 in openstack-manuals "OpenStack Security Guide - Convert to RST format" [High,Triaged] 00:46:50 I’d like to outline what work is needed there, put it in that bug, and volun-script helpers in the sec-guide meeting 00:47:07 ohhhh, i didn't realise that was going ahead in this release 00:47:25 I just saw the HAGuide and Cloud Admin Guide, so I’ll go through there, but any outline on how to proceed, what is automated, and what isn’t would be awesome 00:47:46 loquacities: yeah, we were trying to delay it, but there are several significant sections where contributors just don’t want to deal with docbook 00:48:14 I say they deal with python syntax rules, docbook should be fine, but I seem to be in the minority on that 00:48:18 sicarie: #link https://wiki.openstack.org/wiki/Documentation/Migrate 00:48:27 awesome 00:48:33 ok, we can handle that 00:48:56 i also wouldn't mind a blueprint+spec, if that's possible? 00:49:05 Yep, will do that as soon as the work is scoped 00:49:09 excellent 00:49:13 keep me posted :) 00:49:17 will do 00:49:27 thanks sicarie 00:49:34 other than that I’m working on the Networking security section with Edgar, and starting the Compute review 00:49:39 those are in-flight, nothing else major 00:49:44 cool beans 00:50:01 let's move on to the final few speciality teams, then 00:50:04 #info API docs - Please look at the new spec 00:50:16 #info Networking Guide - Test & review. 00:50:26 #info Ops/Arch Guides - New speciality team! Thanks Shilla https://wiki.openstack.org/wiki/Documentation/OpsGuide 00:50:34 #info Config Ref - New speciality team! Thanks Guavain Details TBA 00:51:00 #info also, FYI, we now have a speciality team catch all page to keep track: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams 00:51:16 any further questions on speciality teams before we move on? 00:51:53 #topic APAC Meetups 00:52:03 #info Planning for an APAC OpenStack meet up in June, ping asettle & adahms 00:52:09 adahms: this is your moment! 00:52:11 Heya 00:52:15 :) 00:52:30 Not much change from the last time we met, I'm afraid 00:52:34 adahms, was going to let us know if there was a date in the near to distant future (before swarm) if we can meet 00:52:35 Ah 00:52:46 Given how much is going on over the next few months, I think the next logical time to meet up will be the swarm 00:52:49 bummer 00:53:01 ok, np 00:53:12 It's just going to be a really busy time of year, I'm afraid :( 00:53:17 #info Planning for APAC Docs Swarm on 13-14 August, ping Suyog 00:53:22 adahms: i know them feels 00:53:27 hello 00:53:29 hi! 00:53:44 The room is all booked and accounted for, suyog ? :) 00:54:03 It is. Though any Pizza/food has to be consumed on level 1. 00:54:06 :) 00:54:16 man, such draconic measures! 00:54:28 I like how pizza is a separate category from food 00:54:34 asettle: can you please send me an email to remind me to chase rackspace swag? 00:54:38 There is pizza, though - this is a good thing 00:54:44 bmoss: it is its own food group 00:54:45 loquacities, can do. 00:54:47 ta 00:54:48 indubitably! 00:54:57 ha ha.. and i like that category is owned by Rackspace :) 00:55:07 so, i know asettle and sunny-dee have been discussing the architecture of that book 00:55:16 is there anything we need to know about that at this stage? 00:55:44 Nothing at the moment. I was talking with bmoss and I haven't heard anything back other than Shilla and her team are happy to help us out 00:55:50 ok, neat 00:55:55 let's move on, then 00:56:02 #topic Ironic Docs 00:56:24 so, devananda and i discussed this at summit 00:56:24 I'd like to start discussing on Ironic documentation for Liberty. 00:56:40 (ping mrda you might be interested here) 00:57:08 at the cross-project workshops? 00:57:08 so, docs don't currently have capacity to bring ironic docs into our repo 00:57:33 pshige: that's right 00:57:54 however i agreed that what we could do is identify a speciality team to help out with editing/writing support 00:58:26 so the ironic docs get writing help to polish them up, but they'll remain in the ironic repos 00:59:41 i think at this stage we need a good idea of what docs you need help with, so we can best identify a team to help you out 01:00:55 pshige: ?? 01:01:07 maybe we should start with the install guide 01:01:11 ok 01:01:22 that's often a good place to start :) 01:01:32 http://docs.openstack.org/developer/ironic/deploy/install-guide.html 01:02:03 #action: Lana to work with Ironic dev team to identify a docs speciality group to help with updating the Ironic Install Guide http://docs.openstack.org/developer/ironic/deploy/install-guide.html 01:02:07 please give us a lot of help to polish it. 01:02:14 we can absolutely do that 01:02:33 it seems instantly logical to me to ask the install guide team, but they're also in the middle of a major RST conversion, so i'll get back to you on that 01:03:06 ok, that wraps up all the formal agenda items i had! 01:03:14 #topic Open discussion. 01:03:14 Thank you! 01:03:20 no trouble pshige 01:03:25 thanks for coming along :) 01:03:34 it's great to have representation from the other groups here from time to time 01:04:25 no other points of order? 01:04:41 Nothing from me. 01:04:50 easy, ok 01:04:51 One email conversation from the openstack-docs list: 01:04:57 JRobinson__: hit me! 01:05:02 Common files in RST conversion can turn up build errors 01:05:38 #info If a common file is in the toc of one guide, consider moving it into the source file for that guide to prevent build errors 01:05:40 JRobinson__: use the :orphan: directive 01:06:02 oh, is that the repetition issue bmoss was seeing a while back? 01:06:07 yep 01:06:11 it persists 01:06:19 right, we might add that to the PSAs for the next meeting 01:06:20 :orphan: is the easiest workaround 01:06:24 #info And the :orphan: directive marking on the file can also prevent sphinx marking the doc as an error 01:06:27 and stick it in the what's up doc for this week, too 01:06:31 but it is a bit of a pain that we need to work around it. 01:06:33 thanks darrenc 01:07:18 yep, thanks for letting me know 01:07:29 np, loquacities bmoss thanks also 01:07:56 ok, thanks everyone 01:08:16 if there's nothing else ... ? 01:08:16 thanks loquacities 01:08:19 loquacities: thanks! 01:08:25 Thanks, loquacities. 01:08:25 thanks all! 01:08:29 #endmeeting