13:01:18 #startmeeting training-guides 13:01:19 Meeting started Tue Nov 15 13:01:18 2016 UTC and is due to finish in 60 minutes. The chair is matjazp. Information about MeetBot at http://wiki.debian.org/MeetBot. 13:01:20 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 13:01:23 The meeting name has been set to 'training_guides' 13:01:28 hey all 13:01:28 o/ 13:01:29 roll call 13:01:45 hey ildikov 13:01:46 o/ 13:01:58 hi matjazp 13:02:15 hi matjazp kmARC ildikov 13:02:28 #link Agenda at https://etherpad.openstack.org/p/training-guides-meeting-agenda 13:02:37 hey kmARC ianychoi 13:03:05 Hello all! 13:03:09 how are you guys? rested from BCN summit? ;) 13:03:43 It was so great to see matjazp for the 1st time offline, although I could not see ildikov and kmARC 13:03:48 yeap, getting there :) 13:04:07 yeap, my bad sorry, I got too overloaded during the week :( 13:04:42 ildikov, that's pretty fine (and I more want to go to Boston to see others!) 13:05:13 we have a usual agenda, so nothing special 13:05:31 there's nothing to review 13:05:41 no lingering action items 13:05:54 clean slate :) 13:06:02 I think it would be much better if we discuss: 1) feedback from BCN upstream training 2) tagging current upstream training material 13:06:03 we had a retrospective meeting last week with the guys and girls who helped out on site 13:06:12 #topic Upstream training 13:06:18 here is the etherpad with the outcome: #link https://etherpad.openstack.org/p/upstream-training-barcelona-retrospective 13:06:40 ildikov : nice 13:07:10 additionally we have a feedback Google doc with responses from students for our survey #link https://docs.google.com/spreadsheets/d/1an2T3twz6rsJhL-sb08uce7hmtSNsc5TLY3F1mGYEUU/edit#gid=0 13:07:30 Thanks a lot.. so nice! 13:07:30 diablo_rojo_phon can give access rights if anyone has issues to open the document 13:07:32 * diablo_rojo_phon sneaks in late 13:07:38 hey diablo_rojo_phon 13:07:43 diablo_rojo_phon: good morning :) 13:08:11 diablo_rojo_phon, hihi! 13:08:26 the basic outcome of the retro and feedback form is more interactions and more hands-on practice 13:08:38 ildikov : does it make sense to distill this feedback to a few graphs and publish it somwhere? Superuser? ;) 13:08:40 this is where we would like ot move the training 13:09:05 matjazp: we have an article coming, it's under final edits 13:09:22 kmARC: and ildikov and I already have written an article for superuser 13:09:23 ildikov: great work! 13:09:34 It should be posted by the end of the week I think. 13:09:46 Great work! I really miss an article for upstream training! 13:09:53 and also once more thanks to all of you for all the effort on this prior to the event!!! 13:10:13 diablo_rojo_phon: +1, thanks for the update 13:10:32 with diablo_rojo_phon we also plan to reach out to the dev community to have more people involved 13:10:35 ildikov: no problem :) 13:11:01 we would also like to bring parts of the training to local events, like OpenStack Days and make it easier to pick up modules for meetups as well 13:11:42 it would be great to have the training formatted more as a hands on practice with quizz and exercises 13:11:45 ildikov: we should prepare a few "scenarios" for using this material in shorter trainings (e.g. openstackDays, Meetups, Usergroups, etc.) 13:12:00 and have a solutions block for those who're all about reading :) 13:12:21 ildikov: hehehe.. beat me to it with typing 13:12:38 matjazp: I agree that it would be great to have more guidelines than what we have today 13:12:50 matjazp: we need to work more on the content first though IMHO 13:13:10 matjazp: :) 13:13:16 For Korean, I am designing a study for 2hr (bi-weekly) x 6 days and all study participants are highly encouraged to paricipate Korean 2nd upstream training next Feb -> That is what I am planning, to stay upstream training with OpenStack Korea user group 13:13:33 ildikov: slice it to even smaller pieces, so we can combine it in different scenarios 13:13:51 ianychoi: sounds very nice, please give us feedback how it goes! :) 13:14:02 longer one for longer, full day trainings, shorter one for shorter events like user groups 13:14:03 ildikov, sure :) 13:14:41 matjazp: on one hand yes and also cut the lecture parts as much as possible 13:15:39 For PyCharm, the request URL can be seen on: https://wiki.openstack.org/wiki/Pycharm 13:16:06 I think a kind of LP activities are needed to receive PyCharm license 13:17:31 ianychoi : why not use community edition? 13:19:08 matjazp, hmm... yep for upstream training, community or educational version may be also good 13:20:04 ianychoi: developers are like snowflakes.. everyone is using a different IDE/editor ;) 13:20:46 :-) 13:21:06 :) 13:22:33 ok, do we need to define some action items here? diablo_rojo_phon and ildikov will send a link to the article to the Docs ML, ok? 13:22:45 +1 13:22:50 matjazp: yeap, we will do 13:23:07 we will use it as an advertisement on the dev ML too 13:23:21 we also need to remove duplications from the slides as we have some currently 13:23:47 #action diablo_rojo_phon ildikov publish link to the upcoming Superuser article on ML 13:23:47 Easy enough to fix :) 13:23:48 I would go for deleting what's duplicated and then continue with rethinking and reorganizing what we have 13:23:54 By the way, ildikov will you go to PTG and open a session for upstream training discussion and/or participation? 13:24:03 ildikov : just submit a bug 13:24:05 Then I think I will also go there 13:24:06 ildikov: +1 13:24:22 yeap, both diablo_rojo_phon and I will be there 13:24:43 we planned to organize something, but we haven't figured it fully out yet 13:25:14 I hope we will have movement before 13:25:22 I see. I indeed want to go to PTG at least from i18n team activities 13:25:29 Lots of movement :) 13:25:34 we can reach out to people directly in Atlanta if we don't have enough people 13:25:59 ianychoi: cool, hope to see you there! :) 13:26:04 Yep okay :) 13:26:22 ildikov: you mean a session about Upstream training and the actual training, right? will there even be a need for Upsteam training at the PTG? 13:26:27 matjazp: yeap, I will submit an umbrella one 13:26:46 And.. are there anyone who would like to change all bug status to invalid and/or fix-released in openstack-dev-sandbox LP? If there no one, then I will do it 13:26:50 matjazp: actual training? 13:27:12 matjazp: PTG itself is for people who're already community memebrs and participating/contributing somewhat actively 13:27:20 matjazp, I think it will not be an actual upstream training 13:27:25 ildikov : yes, exactly 13:27:27 matjazp: so we will not have training there, the next one will be in Boston 13:28:05 oh... i mistyped my line... "and NOT the actual training, right?" 13:28:08 now I see 13:28:12 what you mean 13:28:19 we're on the same page 13:28:25 matjazp: yeap, in that case you were right :) 13:28:40 #link https://bugs.launchpad.net/openstack-dev-sandbox 13:28:53 There are too many bugs from BCN upstream training 13:29:19 ianychoi : you volunteer to manage them? ;) 13:29:22 I think changing all to invalid would be a good idea. Right? 13:29:26 matjazp, sure :) 13:29:37 ianychoi : great :)) 13:30:08 #action ianychoi cleans bug queue from BCN training https://bugs.launchpad.net/openstack-dev-sandbox 13:30:18 Thank you ianychoi :) 13:30:21 Thanks for adding an action, matjazp 13:30:25 ianychoi: yeap, I think 'invalid' will do 13:30:32 ianychoi: also thanks! :) 13:30:47 diablo_rojo_phon, ildikov : It's my pleasure :-) 13:31:30 ok, anything else here? smthng we missed? 13:31:55 I think we touched on the basics 13:32:04 diablo_rojo_phon: kmARC: anything to add? 13:32:19 Nope :) 13:32:24 not from me either 13:32:24 moving on then 13:32:33 #topic training guides 13:33:12 will this also get some developer attention? ;) 13:33:39 I think the Upstream training is doing really great, can we also restart the effort here? 13:34:18 matjazp: the comments regarding the content above was kind of about that I guess 13:34:19 with some basic materials for USERS of OpenStack clouds 13:34:45 ildikov: what do you mean? 13:34:46 matjazp: like user guide type of training? 13:35:16 ildikov : well yes, teach users what cloud offers and how to use openstack 13:35:27 I still think training guides itself is beneficial to users, and it needs to be more relevant to training purposes rather than other documentations (e.g., user-guide) 13:35:56 matjazp: I think I misunderstood the first part 13:36:30 idlikov: effort here == training guides material (minus Upstream training) ;) 13:36:58 matjazp: yeap, now I figured, I'm not that up to date with that though 13:37:23 matjazp: we could get some eyes on that from operators though I think 13:37:30 For last six months, I wanted to more focus on training guides rather than upstream training, but It was happy for me to more focus on upstream training with ildikov diablo_rojo_phon kmARC matjazp csatari katomo and many other contributors :) 13:38:33 ianychoi : yes, Upstream training is doing great, what I'm asking is if we can do something about creating the training material for cloud users, not just prospective oepnstack developers 13:39:15 this is of course a complementary material with other efforts like cloud hackatons etc. 13:39:36 Oh with hackathon would be a great idea 13:40:19 matjazp, may be writing an app on a top of OpenStack using OpenStack REST API? 13:40:51 I can bet that all of us did openstack101 lectures, right? introduce openstack and how to use it to the beginners 13:41:29 ianychoi: thats covered with firstapp guide (or something like that) 13:42:10 http://developer.openstack.org/firstapp-shade/ 13:43:49 I'm talking about creating slides that presenters can just take and use at the introductory openstack talks at user groups/student meetups/etc 13:44:07 matjazp, thanks for the link. But I think documentation and training are different. To develop this, training guides material needs to be organized like a real training material, such as Microsoft Official course book 13:44:09 #link https://www.microsoft.com/en-us/learning/course.aspx?cid=20483 13:44:23 (Just a reference for such details) 13:44:37 ianychoi : yes, the link was for reference, it is not a training material per se 13:45:30 lol 13:47:16 Then... I agree that more user and 101 side on training guides would be much beneficial, rather than current associate guide 13:47:23 #link http://docs.openstack.org/draft/training-guides/ 13:48:31 ok, time's almost up.. moving on, so we don't run out 13:48:42 matjazp, how about using training guides material as 'training guides for upstream training mentors?' 13:49:23 ianychoi: to be a mentor, you need to already know a lot about openstack 13:49:47 ok, we can talk about this on the next meeting 13:49:49 #topic any other business 13:49:49 matjazp, hmm good point :) 13:50:02 And... I want to ask to all: Would it be a good idea to make a branch: stable/newton for current upstream training material? It seems that for the number of words, more than 30% has been changed. IMO branching would be a good idea. 13:50:17 what schedule will we use? 13:50:25 contonuos publishing 13:50:33 continuous 13:50:39 I still like ISO week better as it's consistent 13:50:50 For translation (i18n) sides, branching is a good idea :) 13:51:08 ianychoi: I'm not sure versioning for training material is that useful 13:51:33 ianychoi: we would like people to get the latest most up to date version 13:51:41 to develop for openstack, you need to use what we use, no need to know what we were using in the past ;) 13:51:59 it just add to the confusion 13:52:08 matjazp: 13:52:11 +1 13:52:33 ildikov: I don't care what we use.. we can use ISO nr for weeks 13:52:50 Hmm.. okay For i18n side, I wanted to have translators translation period for training guides, but good point from ildikov and matjazp :) 13:52:57 matjazp: I think we haven't agreed yet, that's why I'm asking 13:53:00 it was just easier for me to remember on the top of my head if we have IRC meeting this week or not 13:53:30 if we use ISO #, I'll just look in my calendar instead :) 13:53:37 what do others prefer? 13:53:51 matjazp: I'm the opposite :) 13:53:55 kmARC ianychoi diablo_rojo_phon 13:54:19 I don't have an opinion TBH :-) 13:55:03 Whatever works. Just let me know. 13:55:03 I'll leave the reservation for every week, though. We may need weekly meetings before the Summit 13:55:35 ianychoi: ? opinions? ISO nrs or week nr of the month? 13:55:44 I don't have strong opinion to both but 1) docs team now restricts to have one meeting per month. training-guides specialty team requested twice per month. Then just 1st/3rd weeks in month would be more logical 2) For my usual schedule, following ISO weeks is better, since my local upstream training study in Korea will be bi-weekly :) 13:56:19 oh.. right. I talked with Lana and she's OK with meetings twice a month 13:56:38 if we try to recruit more people I think ISO weeks is easier to follow 13:56:48 ildikov: :) 13:56:57 although we can separate mentor and actual training format activity from the material 13:57:31 if we think that makes sense and then we can have the schedule of this meeting according ot the regular docs guidelines 13:57:37 ok, lest just use ISO week numbers, like other projects do, ok? any objections? 13:57:48 Then.. I think at least one needs to attend docs team IRC meeting regularly. I think the main purpose of such restriction is that many speciality teams attend their meetings but do not attend docs team meetings.. 13:58:06 ianychoi : I'll take care of that 13:58:23 ianychoi : I can also report to Lana over mail 13:58:33 matjazp: cool, tnx! 13:58:36 I was dont that to the Etherpad anyway 13:58:42 matjazp, thanks! :) Actually new meeting time is good but it is 6am in Korea.. T.T 13:58:44 dont==doing 13:59:01 Then me also +1 for ISO weeks :) 13:59:26 #info we follow ISO week numbers for the IRC meeting 13:59:37 final question.. then may be 13:59:37 time's up 13:59:42 even? or odd weeks? 13:59:49 current week is even week:) 14:00:11 Let's finish and discuss on #openstack-doc irc channel 14:00:16 ok 14:00:18 bye all 14:00:19 I'm fine with even if we don't want to confuse ourselves more :) 14:00:27 #endmeeting