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