17:01:54 <sarob> #startmeeting training-manuals
17:01:55 <openstack> Meeting started Mon Jan 13 17:01:54 2014 UTC and is due to finish in 60 minutes.  The chair is sarob. Information about MeetBot at http://wiki.debian.org/MeetBot.
17:01:56 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote.
17:01:58 <openstack> The meeting name has been set to 'training_manuals'
17:02:01 <colinmcn_> morning
17:02:23 <dguitarbite> sarob,colinmcnamara hello
17:02:24 <dguitarbite> morning
17:02:28 <sarob> morning
17:02:44 <colinmcn_> morning :)
17:03:28 <sarob> #topic action items from last meeting
17:03:46 <sarob> #info active contributors
17:04:29 <sarob> #info sarob is going to check out using stackalytics for inclusion into the the guides
17:04:52 <sarob> no update from me, still pending
17:05:35 <sarob> #info sarob will send out irc meeting rundown to openstack-docs
17:06:19 <sarob> #info quiz dump into https://docs.google.com/a/yahoo-inc.com/document/d/1w7XhcJzdZi_DMT4eenA9rBY7n3uPieCzIfllaQZkXag/edit?usp=sharing
17:07:09 <dguitarbite> as you see I have put some basic info as per my observations
17:07:13 <sarob> dguitarbite give us a quick run down
17:07:21 <dguitarbite> the GDoc has been filled by me as requested, I have also deployed Moodle for testing purposes, you may find moodle here .. http://os-trainingquiz.aptira.com/
17:07:22 <dguitarbite> I am sending you the required login credentials via email.
17:07:22 <sarob> dguitarbite: i see
17:08:01 <dguitarbite> check your email for login, we can do some testing on Moodle till we are sure about how to use it exactly
17:08:08 <sarob> dguitarbite: implementation details
17:08:56 <dguitarbite> ok, about 1GB Ram, 2 VCPUs and 50GB Hdd space should provide at least 50 concurrent users for one course
17:09:08 <sarob> cool
17:09:12 <dguitarbite> we need to scale the hard drive space as per the storage requirements
17:09:31 <sarob> idea on how to move the quiz questions to moodle?
17:10:58 <dguitarbite> yes, we can create a course, design selected forms and ask the contributors to submit them, the course admin (we need to come up with some names here) will accept or reject it
17:11:23 <dguitarbite> I dont know how to integrate this with gerrit based system but we can find some hooks
17:11:45 <dguitarbite> *ask the contributors to fill and submit forms
17:13:42 <sarob> Implementation steps/details, Using openstack.org and/or launchpad auth, Migrating training-guides quizzes to Moodle, Tracking Moodle user results:
17:14:14 <sarob> these four things would allow us to start using moodle i think
17:14:40 <dguitarbite> Tracking Moodle User Results is as simple as installing Analytics plugin
17:15:08 <colinmcn_> thats pretty awesome
17:15:13 <sarob> cool, can you explain in the gdoc how that gets installed/added?
17:15:29 <dguitarbite> we can see if Moodle can use the same DB for Login -- so easy to login via OpenStack.org
17:15:47 <sarob> we need to get this to a wiki howto
17:15:57 <sarob> very simple and to the point
17:16:07 <sarob> then we could hand off to infra
17:16:47 <dguitarbite> yea, let me look into the login system and migration of existing quizzes
17:16:52 <sarob> we should plan on handing off to infra as quickly as possible
17:16:59 <dguitarbite> yes
17:17:00 <sarob> awesome
17:17:29 <dguitarbite> as of installing modules its similar to wordpress/ other PHP based CMS
17:17:40 <sarob> #action dguitarbite continue to work on gdoc https://docs.google.com/a/yahoo-inc.com/document/d/1w7XhcJzdZi_DMT4eenA9rBY7n3uPieCzIfllaQZkXag/edit?usp=sharing
17:17:51 <dguitarbite> so its a bit of infra work
17:18:16 <dguitarbite> *infrastructure related
17:18:25 <sarob> dguitarbite: goal of infra handoff by 01feb?
17:18:36 <sarob> two weeks?
17:18:44 <dguitarbite> just a second let me check my cal
17:19:38 <dguitarbite> can we make it 8th? I am travelling from 20th Jan for a week
17:19:46 <dguitarbite> *8th Fev
17:19:49 <dguitarbite> *Feb
17:20:10 <sarob> roger that
17:20:45 <sarob> #action dguitarbite moodle handoff readiness 08feb2014
17:21:50 <sarob> #info quiz questions/answers
17:22:52 <sarob> i have one outstanding quiz bug to review
17:23:27 <sarob> who else can we encourage to summit quiz bugs?
17:24:17 <colinmcn_> my opinion
17:24:22 <colinmcn_> is that when we start giving alpha's
17:24:23 <colinmcn_> or
17:24:32 <colinmcn_> maybe that is an action item for meetup groups
17:24:43 <colinmcn_> that could be something short and actionable
17:24:49 <colinmcn_> that we can get out through the community
17:25:30 <sarob> i like that
17:26:12 <sarob> colinmcn_ ideas on how we could do that?
17:26:13 <colinmcn_> I can also encourage the various community members that blog
17:26:18 <colinmcn_> to write up articles
17:26:24 <colinmcn_> in a perfect world
17:26:32 <colinmcn_> we contact the key members through the community list
17:26:41 <colinmcn_> and then package up a 5 min deck
17:26:46 <colinmcn_> that goes through goals and process
17:26:48 <sarob> colinmcn_: can you write up a brief plan?
17:26:52 <colinmcn_> yeah
17:26:57 <colinmcn_> yes, I will
17:27:03 <sarob> colinmcn_: its seems similar to what you are already working on
17:27:21 <sarob> colinmcn_: i could use it for yahoos too
17:27:29 <colinmcn_> yup, short consumable
17:27:34 <colinmcn_> easy to deliver
17:27:45 <colinmcn_> basically we ask the user group members to give 5 min
17:27:53 <colinmcn_> or possibly record a video to play
17:27:54 <colinmcn_> or both
17:28:19 <sarob> #action colinmcnamara training guides contribution how to for user groups and corporate
17:28:20 <dguitarbite> is it like a survey asking for quiz questions ?
17:29:48 <sarob> dguitarbite i need feedback from sina on how the aptira training guides experience is going
17:30:06 <sarob> can you ping him to reach out to me?
17:30:23 <dguitarbite> yep, sure
17:30:30 <dguitarbite> do you want his Skype Contact?
17:31:09 <sarob> sure, how about you send an email to both of us with contact info and what we need
17:31:23 <dguitarbite> sounds good
17:31:50 <sarob> #action dguitarbite email sina and sarob on commercial training guides experience so far
17:32:48 <sarob> colinmcn_ what was the dudes name that just published at the summit?
17:32:57 <colinmcn_> ?
17:33:03 <colinmcn_> that dudes name that just published
17:33:07 <colinmcn_> cody banks?
17:33:12 <sarob> righto
17:33:15 <colinmcn_> err cody bunch
17:33:22 <sarob> hah, right
17:33:24 <colinmcn_> the racker who wrote a book
17:33:35 <sarob> yeah, brainfart
17:33:49 <colinmcn_> it's ok. my brain is more fart then brain
17:34:05 <sarob> time to bug him? maybe ed, you, i
17:34:24 <sarob> lunch to strategize on guides and publishing
17:35:08 <sarob> chew on it, we can discuss later
17:35:34 <colinmcn_> yeah, I think so
17:35:38 <colinmcn_> he is a great guy
17:35:43 <colinmcn_> however I think what we are seeing
17:35:52 <colinmcn_> is the community waiting to see something tangible to engage
17:35:57 <colinmcn_> people act in their self interest
17:36:00 <colinmcn_> it's just reality
17:36:05 <colinmcn_> I think what we have
17:36:13 <colinmcn_> is something that aligns to their self interest
17:36:28 <colinmcn_> an action item that I think we have to track
17:36:36 <colinmcn_> is how to communicate that self interest to the world
17:36:57 <sarob> colinmcn_:  id like to hear what they want to see that would link in the self interest
17:37:13 <colinmcn_> so, good example
17:37:30 <colinmcn_> look at how @jtroyer in VMware communities incites action in the community
17:37:39 <colinmcn_> we can go into it for days
17:37:52 <colinmcn_> so, publicity
17:37:59 <colinmcn_> gaining knowlege
17:38:03 <colinmcn_> certifications
17:38:03 <colinmcn_> pay
17:38:12 <colinmcn_> social credibility (fame)
17:38:28 <colinmcn_> all area's of self interest that people take action around
17:38:51 <colinmcn_> e.g. that's why people always pile on towards the end of a successful project
17:38:55 <sarob> colinmcn_: this kinda aligns with your action item
17:39:00 <colinmcn_> yup
17:39:14 <colinmcn_> we can't change human nature, but we sure as hell can accept it and leverage it
17:39:42 <colinmcn_> I think one actionable item is working with Steph to write a highlight on Dguitarbyte
17:39:54 <colinmcn_> show the world all the hard work, and amazing contribution that has been done
17:39:58 <sarob> colinmcn_: i like
17:40:14 <sarob> sounds like you have a start of a good plan then :)
17:40:14 <colinmcn_> :)
17:40:18 <colinmcn_> yup
17:40:23 <colinmcn_> created a card in trello
17:40:25 <dguitarbite> im on with certificates
17:40:25 <dguitarbite> *on board
17:40:25 <colinmcn_> with some checklist items
17:40:30 <sarob> cooolo
17:40:38 <sarob> next item
17:40:41 <sarob> #info complete aptira content merge into training guideshttps://docs.google.com/a/yahoo-inc.com/drawings/d/1ju78O-PjkZIeSbpGkUndIohQeQy06QXseRPbCy2F6F8/edit?usp=sharing
17:40:43 <dguitarbite> we can have wide adoption of Training Manuals with it
17:40:49 <sarob> yup
17:41:16 <sarob> so we need to finish the merge up
17:41:28 <sarob> we are about 3/4 of the way done
17:41:33 <sarob> lets finish it
17:42:41 <sarob> the associate guide merge is done, lets finish whats left on the operator guide
17:42:54 <colinmcn_> topic change?
17:43:19 <sarob> still old action items
17:43:24 <colinmcn_> k
17:43:58 <sarob> ehh, okay, new topic
17:44:38 <colinmcn_> I was just sanity checking, not complaining
17:44:42 <dguitarbite> is the basic install guide still there in manuals?
17:44:48 <sarob> #topic complete operator guide layout, include final aptira content merge
17:44:52 <dguitarbite> or should I update one for Operator (Havana)?
17:45:14 <sarob> dguitarbite basic install guide is gone
17:45:36 <sarob> #link https://docs.google.com/a/yahoo-inc.com/drawings/d/1ju78O-PjkZIeSbpGkUndIohQeQy06QXseRPbCy2F6F8/edit?usp=sharing
17:45:55 <sarob> this is the december reorg plan
17:46:07 <sarob> associate guide is done
17:46:27 <sarob> operator guide layout needs some cleanup
17:46:54 <sarob> part of the sina conversation is how does aptira use the training guides
17:47:20 <sarob> are they using the aptira books or the training guide books?
17:47:42 <dguitarbite> we are using Training Guide Books
17:47:51 <dguitarbite> all open source
17:47:58 <sarob> should we add content switches like the install guides for commercial training use like aptira?
17:48:27 <sarob> the training guides set has eight books right now
17:48:49 <sarob> it should only be 5: start here, assoc, oper, dev, arch
17:48:57 <dguitarbite> yes, we should add a basic install section (attacts more new commers)
17:49:14 <dguitarbite> I guess for Operators it may be required
17:49:14 <sarob> ehh? you lost me
17:49:30 <sarob> ah, right
17:49:43 <sarob> install labs are in operators guide
17:50:02 <sarob> along with how to contribute docs bug fixes
17:50:11 <sarob> and administrative tasks
17:50:34 <dguitarbite> sarob " should we add content switches like the install guides for commercial training use like aptira? " honestly, I do not know
17:51:03 <sarob> im assuming that aptira wants to create your own flavor of the same content plus some extra
17:51:45 <dguitarbite> just for Associate
17:51:47 <sarob> id like to understand how sina is using the content and his plans
17:52:07 <dguitarbite> yes, I will ask him to get in touch with you
17:52:12 <sarob> so we can clean up the repo and finish the operator design
17:52:36 <dguitarbite> yeah, I think we can add some videos on install guide section if possible
17:53:16 <sarob> #action dguitarbite sarob finalize clean up of up aptira content in repo
17:53:45 <sarob> #topic any other business, new items
17:54:05 <colinmcn_> I have two things
17:54:36 <colinmcn_> 1. I am continuing down the path of building an AsciiDoc << >> docbookbooks translation enginee
17:54:44 <colinmcn_> things are moving slowly, but moving
17:55:12 <colinmcn_> and it looks like we may be able to remove the requirement for Oxygen and XML tagging to author training docs
17:55:22 <colinmcn_> I'll keep everyone informed on progress
17:55:35 <colinmcn_> I'm beta'ng out the process in OpenDaylight - OVSDB project
17:55:50 <dguitarbite> colinmcn_ awesome
17:55:52 <colinmcn_> all the doc work there is built to map right into the OpenStack docbooks toolchain
17:56:06 <sarob> colinmcn_ cool
17:56:07 <colinmcn_> If I never have to open up Oxygen, or debug and XML build error again in my life
17:56:10 <colinmcn_> it will be a happy day
17:56:16 <colinmcn_> but still be able to author content
17:56:20 <sarob> hmm, yes
17:56:20 <colinmcn_> 2nd thing
17:56:26 <colinmcn_> 2. item
17:56:36 <colinmcn_> in the 332 engineers at work
17:56:42 <colinmcn_> I found out that we have a tech writer
17:56:56 <colinmcn_> I don't know if it will get approved
17:57:08 <colinmcn_> but I am submitting and internal project to assign him part time to this project
17:57:17 <sarob> wow, nice
17:57:25 <sarob> ill get you a muffin
17:57:30 <sarob> as thanks
17:57:39 <colinmcn_> the internal project approval cycle takes 90 + days
17:57:41 <sarob> breakfast thanks theme
17:57:44 <colinmcn_> but, it's a resource
17:57:55 <sarob> 3 months would be outstanding
17:58:03 <dguitarbite> colinmcn_ "If I never have to open up Oxygen, or debug and XML build error again in my life" -- if you implement this system, your expertise will be called upon for fixing weird situations, adding new features and more ... althought it will be more fun than editing XML ...
17:58:10 <sarob> we can get a lot done in three months
17:58:20 <colinmcn_> I'm also putting into to take one of our ASE's (associate systems engineers) and apply them as an intern
17:58:45 <colinmcn_> again, I have to fight internal process and budgets. But I thought I would share
17:59:00 <colinmcn_> dguitarbite: basically we have david kramer
17:59:10 <colinmcn_> as the one guy who can fix all things docbooks
17:59:24 <colinmcn_> I feel that random build errors
17:59:26 <dguitarbite> kool
17:59:30 <colinmcn_> are bugs in the system
17:59:41 <colinmcn_> shouldn't be there for a content contributor to deal with every day
17:59:43 <colinmcn_> my 2 cents
17:59:58 <colinmcn_> that's what I have to share
18:00:50 <sarob> excellent
18:00:59 <sarob> anything else?
18:01:11 <colinmcn_> i'm good
18:02:43 <sarob> lets close up
18:02:48 <colinmcn_> agreed
18:02:52 <dguitarbite> yep (yawn)
18:02:56 <sarob> #endmeeting