14:02:10 #startmeeting docteam 14:02:10 Meeting started Wed Aug 12 14:02:10 2015 UTC and is due to finish in 60 minutes. The chair is ShillaSaebi. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:02:11 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 14:02:14 o/ 14:02:14 The meeting name has been set to 'docteam' 14:02:24 o/ 14:02:26 saggi I will provide the agenda wiki ahead of the meeting 14:02:26 Hi 14:02:35 hi katomo 14:02:44 #topic Action items from the last meeting 14:02:59 i can't see any action items we should be following up on on the agenda so that was easy 14:03:12 ha 14:03:15 #topic Liberty specs in review 14:03:26 #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z 14:03:49 #link https://review.openstack.org/#/c/191041/ (Third Party driver docs - requires discussion) 14:04:06 I'm merging the install guide spec 14:04:34 we haven't had any action on that third party spec for a while, Lana mentioned sending some e-mails on that 14:04:46 I haven't seen any but I could've easily missed them, I was on vacation last week 14:05:07 #link https://review.openstack.org/#/c/191077/ (Install Guide Liberty update) 14:05:15 awesome annegentle 14:05:29 any questions on specs? 14:05:45 alrighty 14:05:47 #topic Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams 14:06:06 #info HA Guide - RST migration complete, need help with updating content. 14:06:17 #link https://review.openstack.org/#/c/191077/ (Install Guide Liberty update - WIP) 14:06:24 oops sorry wrong link 14:06:29 #info Install Guides - RST migration nearly complete, testing to begin shortly. 14:06:39 #info Networking Guide - Test & review for Liberty updates. Need to audit content in devref. 14:06:48 #info Security Guide - RST conversion started, sign up here: #link https://etherpad.openstack.org/p/sec-guide-rst 14:06:55 ShillaSaebi: That'S outdated 14:07:01 Security Guide is finished! 14:07:05 oh great news!! 14:07:06 completed 14:07:08 woo hoo 14:07:09 nice 14:07:11 https://review.openstack.org/#/c/211766/ is the patch to publish it! 14:07:11 very nice 14:07:17 annegentle: Want to +2A? 14:07:20 what remains to be migrated on the Install Guide? 14:07:26 with pleasure! 14:07:38 After that one is in, some cleanup for the Security Guide can be done (most are already proposed) 14:07:42 alright, i will take a look at this today 14:07:50 great! 14:08:30 #info User Guides - Cloud Admin Guide RST migration complete, need to start work on reorganization. 14:08:42 thanks AJaeger -- is there any way to collect all those so that other people can study "here's what you do when the RST conversion is done"? 14:08:56 ShillaSaebi: I would say: Nearly complete. We still have the DocBook guide and publish from there for the Cloud Admin Guide 14:08:57 collect all those patches I mean. I guess you make them dependent already 14:09:15 annegentle: let me write something up 14:09:30 annegentle: here 14:09:37 annegentle: here'S what we did last time: https://wiki.openstack.org/wiki/Documentation/Migrate#Publishing_User_Guides 14:09:59 Let me clean that up for the generic case... ShillaSaebi give me an action item, please ;) 14:11:04 annegentle: looks like the install guide is migrated; just needs formatting and testing work 14:11:19 annegentle: Install Guide migration has been completed, except for Debian, which has another blueprint. 14:11:54 #action AJaeger to write something up for collecting patches and steps for when conversions are completed 14:12:11 KLevenstein: We need to do the final cleanup, I'll document and send an email ^ 14:12:24 AJaeger: thanks 14:12:47 cool 14:12:54 #info Ops/Arch Guides - Arch Guide swarm coming up. #link https://wiki.openstack.org/wiki/Documentation/OpsGuide 14:13:45 #info API docs - Spec is now merged! #link https://wiki.openstack.org/wiki/Documentation/API 14:14:10 there's progress, Russell should send an email to the ML soon 14:14:31 ok 14:14:38 and I've updated the spec last week to include publishing more "narrative" info 14:14:42 to developer.openstack.org 14:14:53 great ty 14:15:02 actually I will study that wiki page AJaeger and see if it's relevant to what I need to do on developer.openstack.org 14:15:22 #link https://review.openstack.org/#/c/209669/ 14:16:17 #info Config Ref - New speciality team thanks to Guavain! #link https://wiki.openstack.org/wiki/Documentation/ConfigRef 14:16:46 anything else on specialty teams? 14:17:07 #topic Doc tools update 14:17:18 #info new theme ready to be released soon 14:17:27 WE relesaed openstackdocstheme 1.2.0 yesterday 14:17:54 It includes the dynamic TOC and next/previous/report a bug links at the bottom of pages 14:18:13 great 14:19:00 did anyone else think it looks slightly different from docs-draft? 14:19:02 I haven't dug into it 14:19:20 let me dig up two links for comparison 14:20:08 #link http://docs.openstack.org/user-guide/ 14:20:10 compared to 14:20:32 #link http://docs-draft.openstack.org/70/208370/7/gate/gate-openstackdocstheme-docs/3b035a1//doc/build/html/ 14:20:40 are the fonts under Contents different? 14:21:05 annegentle: not on my Linux system 14:21:34 they look the same to me 14:21:59 looks same to me in my environment. 14:22:01 #link https://4c8a2d4366ae8252119f-ed3df21bb39de4e57eec9a20aa0b8711.ssl.cf2.rackcdn.com/Screen%20Shot%202015-08-12%20at%209.21.10%20AM.png 14:22:04 Chrome on Mac 14:22:17 Safari on Mac 14:22:33 Firefox on LFedora 14:22:44 looks same to me 14:22:51 ok with that link it looks like one is smaller than the other 14:22:53 same font though 14:23:01 ah nevermind. At one point I had 110% on docs.openstack. FFF 14:23:05 hahaha 14:23:05 nothing to see here :) 14:23:09 no worries 14:23:14 good eye though 14:23:15 I thought I was going crazy :) 14:23:25 np :) 14:23:34 ok that's embarrassing :) 14:23:51 nahhhhhh 14:23:54 :) 14:24:15 #topic Licencing 14:24:28 last update I have is that annegentle and Lana were discussing with legal on this 14:24:45 #info Lana and Anne are consulting with legal on this 14:24:57 yeah we had a good meeting with Lisa Miller, she's a counsel for the Foundation 14:25:09 I patched 2 guides that were plainly wrong by having cc-by-sa 14:25:17 and here's a wiki page with the latest 14:25:34 #link https://wiki.openstack.org/wiki/Documentation/ContentSpecs#Licenses 14:25:56 ty 14:26:04 I haven't yet patched the install guides and we don't plan to patch stable branches. 14:26:25 Was sort of waiting to see where the RST sits since for that output it's plainly cc-by 3.0 14:26:57 Mostly this confusion is resolved by getting everything in the same template 14:27:04 but we have a little ways to go. 14:27:10 that's all I have to report, any questions? 14:27:20 nope, thanks annegentle 14:27:29 #topic APAC Meetups 14:27:40 #info Reminder: APAC Docs Swarm on 13-14 August, ping Suyog 14:27:55 #topic Spotlight bugs 14:28:06 #link https://bugs.launchpad.net/openstack-manuals/+bug/1257018 VPNaaS isn't documented in cloud admin 14:28:06 Launchpad bug 1257018 in openstack-manuals "VPNaaS isn't documented in cloud admin" [Medium,Confirmed] 14:28:09 Launchpad bug 1257018 in openstack-manuals "VPNaaS isn't documented in cloud admin" [Medium,Confirmed] 14:28:10 Launchpad bug 1257018 in openstack-manuals "VPNaaS isn't documented in cloud admin" [Medium,Confirmed] https://launchpad.net/bugs/1257018 14:28:13 #link https://bugs.launchpad.net/openstack-manuals/+bug/1257656 VMware: add support for VM diagnostics 14:28:13 Launchpad bug 1257656 in openstack-manuals " VMware: add support for VM diagnostics" [Medium,Confirmed] 14:28:13 Launchpad bug 1257656 in openstack-manuals "VMware: add support for VM diagnostics" [Medium,Confirmed] 14:28:15 Launchpad bug 1257656 in openstack-manuals "VMware: add support for VM diagnostics" [Medium,Confirmed] https://launchpad.net/bugs/1257656 14:28:19 #link https://bugs.launchpad.net/openstack-manuals/+bug/1261969 Document nova server package 14:28:19 Launchpad bug 1261969 in openstack-manuals "Document nova server package (WAS: Enable remote debugging for nova)" [Low,Confirmed] 14:28:20 Launchpad bug 1261969 in openstack-manuals "Document nova server package (WAS: Enable remote debugging for nova)" [Low,Confirmed] 14:28:21 Launchpad bug 1261969 in openstack-manuals "Document nova server package (WAS: Enable remote debugging for nova)" [Low,Confirmed] https://launchpad.net/bugs/1261969 14:29:03 any questions? 14:29:26 alright 14:29:29 anything anyone wants to bring up? 14:29:33 #topic open discussion 14:29:50 ok 14:30:01 early end to the meeting 14:30:11 thanks everyone for joining and see you soon! 14:30:12 I want to be sure you all are aware of Technical Committee stuff going on, like the stackforge renames going away? 14:30:15 wait! 14:30:20 thanks 14:30:24 hah 14:30:25 still here 14:30:30 :) 14:30:38 We've been writing blog posts to keep everyone updated 14:30:40 #link http://www.openstack.org/blog/category/technical-committee-updates/ 14:30:48 great thanks annegentle 14:30:54 Ive been behind on email and playing catch up this week 14:30:57 Also, it's past halfway through the liberty cycle and we're doing just fine. 14:31:03 thats good 14:31:14 Also, welcome to our newest core member!!! 14:31:14 I will take a look 14:32:02 welcome welcome Katomo! 14:32:25 We appreciate all the work you put in and look forward to more good doc'in 14:32:37 thanks annegentle ShillaSaebi 14:32:41 Super happy to have you! 14:32:47 absolutely! 14:33:09 alright anything else I missed or anyone wants to bring up? 14:33:12 It's my pleasure 14:33:15 that was it, the stackforge thing is going to cause a lot of questions. 14:33:23 at least my spidey sense thinks so :) 14:33:27 hehe 14:33:33 I'm sure it will 14:33:53 I'll catch up hopefully this week and raise any Qs i have 14:34:13 annegentle: Documentation for the last steps of RST conversion is at https://wiki.openstack.org/wiki/Documentation/Migrate#Completing_conversion_to_RST 14:34:13 alrighty team looks like that's all for now 14:34:23 that was quick AJaeger 14:34:32 nice work AJaeger 14:34:34 * AJaeger welcomes katomo! 14:34:40 ShillaSaebi: #info it ;) 14:34:40 cool 14:34:56 ShillaSaebi, annegentle: That's the first iteration, need to double check it... 14:35:00 #info Documentation for the last steps of RST conversion is at #link https://wiki.openstack.org/wiki/Documentation/Migrate#Completing_conversion_to_RST 14:35:03 great AJaeger 14:35:11 #link https://wiki.openstack.org/wiki/Documentation/Migrate#Completing_conversion_to_RST 14:35:11 ok 14:35:35 alrighty anything else? 14:35:48 none 14:36:03 cool thanks everyone and see you soon! 14:36:15 #endmeeting