14:05:40 #startmeeting docteam 14:05:41 Meeting started Wed Nov 18 14:05:40 2015 UTC and is due to finish in 60 minutes. The chair is ShillaSaebi. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:05:42 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 14:05:45 The meeting name has been set to 'docteam' 14:06:07 hi everyone :) 14:06:11 hi 14:06:25 o/ 14:06:41 hi 14:06:44 o/ 14:06:54 #topic Action items from the last meeting 14:07:10 boss was to look into documenting openstack-doc-tools and the index page reorg 14:07:20 hi 14:07:21 bmoss sorry 14:07:47 and suyog was to look into the index page summaries 14:08:00 do we have any updates on those items? bmoss and suyog are you around? 14:08:41 hmmm ok we will probably get an update on those items in the APAC meeting since that's when the action item was formed 14:08:57 yeah 14:09:03 #topic Specs in review 14:09:11 #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z 14:09:24 #link https://review.openstack.org/#/c/240879/ (Upgrades) 14:09:33 #link https://review.openstack.org/#/c/238770/ (User Guide reorg) 14:09:41 #link https://review.openstack.org/#/c/227660/ (Ops Guide reorg) 14:09:48 #link https://review.openstack.org/#/c/224420/ (DocImpact) 14:10:30 #link https://review.openstack.org/#/c/246660/ (app developer docs) 14:10:31 the upgrades one was merged 14:10:42 thanks berendt 14:11:07 any questions or comments on specs? 14:12:10 o/ 14:12:40 "Upgrades" impact "Ops Guide reorg" 14:12:43 #topic Specialty Teams 14:12:48 #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams 14:13:29 #info HA Guide - New speciality team formed under Bogdan Dobrelya. 14:13:50 #info Install Guides - RDO published. Debian still on hold. New speciality team formed under Christian Berendt - berendt 14:14:03 #info Networking Guide - New speciality team formed under Edgar Magana for Mitaka. 14:14:08 #info Security Guide - no update. 14:14:14 #info User Guides - Please review spec 14:14:20 #info Ops/Arch Guides - Please review specs 14:14:26 #info API docs - Fairy Slipper conversion underway: http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html 14:14:32 #info Config Ref - Waiting on RST conversion spec. 14:14:38 #info OpenStack Training Labs - Contact Pranav Salunke #link https://wiki.openstack.org/wiki/Documentation/openstack-labs 14:14:44 #info OpenStack Training Guides - Contact Matjaz Pancur #link https://wiki.openstack.org/wiki/Training-guides 14:14:50 #info Hyperviser Tuning Guide - Contact Joe Topjian 14:15:09 please note there is a poll to shift HA guide IRC meeting time http://doodle.com/poll/by7axmzznrcv59zf 14:15:24 so far only 3 persons participated including me 14:15:40 i saw something go out to the ML 14:15:55 ConfigRef conversion has already started (spec approved) 14:16:14 yes, it is http://lists.openstack.org/pipermail/openstack-docs/2015-November/007865.html 14:16:28 bogdando maybe try sending an email to the folks who helped with the RST migrations for the HA guide and see if there will be some more participation? 14:16:44 will do, thanks 14:16:49 bogdando: and send a reminder to the mailing list 14:17:22 anything else on the specialty teams? 14:17:50 not for install at the moment 14:18:07 ok 14:18:17 #topic Countdown to Mitaka 14:18:29 140 days! 14:18:37 #link http://www.timeanddate.com/countdown/launch?iso=20160407T00&p0=1440&msg=OpenStack+Mitaka+Launch+Date&font=cursive 14:18:53 We are looking for volunteers to help document the openstack-doc-tools 14:19:31 #info We also need volunteers to help reorganize the index page and write one-sentence summaries. The API docs have already been moved off. 14:20:04 so that was the action item we had from bmoss last week 14:20:19 and suyog for the index items 14:20:40 so it's best for us to wait for the update before finding new volunteers :) 14:21:07 I can help with openstack-doc-tools 14:21:31 I already chatted with Andreas to clarify if we can re-use the existing doc/source directory for the documentation. this will work. 14:21:55 #action berendt to help with documenting openstack-doc-tools 14:22:02 oh cool thanks! 14:22:16 fyi you were volunteered at the last meeting heh 14:22:50 great 14:22:52 ha :) 14:24:12 berendt: :) 14:25:12 alright any questions on that? 14:25:16 comments? 14:25:17 concerns? 14:25:28 alright moving along 14:25:35 #topic Spotlight bugs 14:26:04 #info Our new rewards scheme for closing out old bugs will be announced soon 14:26:21 the one with the missing google analytics 14:26:50 at the moment I am not sure with solution is the correct one, the one proposed by russel differs from the one lauren send to u 14:27:26 #link https://review.openstack.org/#/c/246376/ (openstackdocstheme google analytics) 14:27:44 #link https://review.openstack.org/#/c/246181/ (openstack-manuals google analytics) 14:28:27 I didn't get a chance to look at these yet 14:28:57 I saw annegentles email about it 14:29:01 I will take a look today 14:29:53 and the idea behind the closing bugs reward program will be that if you close X amount of bugs you get a free X (swag of some sort) 14:30:08 something fun to motivate us to close more bugs 14:30:15 ShillaSaebi: That sounds awesome! 14:30:24 yeah I love the idea dguitarbite 14:30:49 sounds good to me :) a lot of swag.. ;) 14:30:54 as of last week, loquacities was still brewing up the plan and working on it 14:30:59 That's awesome... who pays for the free X? 14:31:06 feel free to send suggestions her way, new car maybe? 14:31:12 Foundation :P 14:31:36 nice 14:31:44 :) 14:31:45 OpenStack foundation yet 14:31:47 yes* 14:32:11 any questions on the rewards prog? 14:32:57 oh it could be stuff from this store I believe: http://store.openstack.org/promotional-items.html 14:33:21 ok moving along 14:33:25 #topic Open discussion 14:33:33 anyone have anything they would like to bring up or discuss? 14:33:57 there is no car in the store :( 14:34:02 hahaha 14:34:06 :( 14:34:07 I would like to give some status update on training labs 14:34:18 sure dguitarbite we'd love to hear it 14:34:19 orz 14:34:56 Kilo port is almost complete, review should be merged in the next day or so https://review.openstack.org/#/c/237061/ 14:35:23 Some other minor fixes/features are added. 14:35:27 nice 14:35:39 I can take a look at this today 14:35:44 We aim to finish Liberty soonish. 14:35:55 dguitarbite: can you take care of the "how to use the training labs with the install guide" thread ? 14:36:00 nice 14:36:13 berendt: ok, Ill followup in there. 14:36:15 ShillaSaebi: I have an App dev guide spec ready for review here: https://review.openstack.org/#/c/246660/ 14:36:19 dguitarbite: thanks 14:36:27 #link https://review.openstack.org/#/c/246660/ 14:36:30 #action dguitarbite: Add training labs how to to install-guides thread 14:36:40 cool thank you annegentle 14:37:05 great, ill set aside some time to look at these today too 14:38:12 anyone have anything else to bring up? 14:38:14 o/ 14:38:37 Hi all, I'll be the doc liaison for keystone this cycle (as determined by our fearless ptl!). I just wanted to drop by and let you all know that if you need anything keystone-wise, please don't hesitate to reach out. 14:38:49 hi lbragstad 14:38:52 thank you for letting us know 14:39:05 we appreciate it :) 14:39:08 ShillaSaebi no problem, looking forward to it :) 14:39:24 alright! we have about 20 min left on the clock 14:39:32 if nobody has anything to bring up, I will go ahead and call it 14:39:40 i have 14:39:43 http://docs.openstack.org/contributor-guide/rst-conv/inline-markups.html 14:39:57 :program:`RabbitMQ` 14:40:12 :command:`nova boot` 14:40:31 do we need this conventions? simply use `` `` ? 14:41:19 thats the syntax right 14:41:37 the actual output shouldn't have that 14:42:03 for filename and path we have the doubles 14:42:33 yeah 14:42:49 katomo: use it like described in the conventions and ignore those comments written by me in the review request :) 14:43:28 berendt: we use `` `` for filename and path 14:44:01 for consistency and simplicity, i would like to use `` ``. 14:44:37 ok 14:44:38 i dont know the reason program and command is special. 14:44:43 katomo: this has to be discuess on the mailing list, can you propose it there? 14:44:50 do you want to start something on the ML 14:44:50 sure 14:44:52 jinx! 14:45:00 yeah I think it's better if we start the conversation there 14:45:12 get some input...and then move fwd from that point 14:45:17 katomo: I commented in the review request that use of :program: and :command: is fine at the moment, but I +1 to only use `` 14:45:48 berendt: thanks 14:46:11 alright, great 14:46:17 anything else anyone wants to bring up? 14:46:36 none 14:47:01 ok well, I will go ahead and call it then. Thank you all for joining and see you soon! 14:47:06 #endmeeting