13:01:07 #startmeeting training-guides 13:01:08 Meeting started Tue Oct 4 13:01:07 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:10 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 13:01:12 hey all 13:01:13 The meeting name has been set to 'training_guides' 13:01:14 roll call 13:01:20 o/ 13:01:37 Hi all! 13:01:39 #link Agenda at https://etherpad.openstack.org/p/training-guides-meeting-agenda 13:01:49 hey ianychoi_phone ildikov 13:02:13 hi 13:02:20 o/ 13:02:24 :) Nice to see all in new time slot :) 13:02:30 ianychoi_phone: you can go to bed much earlier today ;) 13:02:34 Wow hi csatari and kmARC ! 13:02:38 Yey~~! 13:02:41 hey csatari kmARC 13:02:58 yeah, I arrived on time to the beautiful Frankfurt 13:03:00 hi All :) 13:03:12 Wow Frankfurt..! 13:03:16 kmARC: I'm glad you made it :) 13:03:21 kmARC: you're at the airport? 13:03:51 Hello 13:03:57 that's a nice one, I had meeting there before :D 13:04:00 Hello diablo_rojo_phon ! 13:04:06 hey diablo_rojo_phon 13:04:26 matjazp: No I'm already at hotel 13:04:33 I came by car 13:04:43 kmARC: much better than airport :) 13:04:45 this meeting slot looks good so far 13:04:54 * matjazp looks at the agenda 13:05:00 I agree thank a lot ildikov 13:05:04 matjazp: I will put up a patch to secure this channel, when you confirm it too 13:05:26 ildikov: yes, as soon as I get my winter schedule 13:05:42 ianychoi_phone: we cannot do it any earlier, or I need to look for a completely other slot that can fit to everyone :( 13:05:53 the problem is that my schedule changes twice a year (winter and summer term) 13:06:01 ianychoi_phone: but please let us know if it's still close to undoable for you 13:06:37 matjazp: got it, I hope this slot works out and then we will see how things go later 13:06:50 ildikov: That's completely fine to me. I hope that matjazp 's schedule will also fit :) 13:07:45 cool, tnx all for the quick votes, etc :) 13:07:50 ildikov: sadly, I can confirm just for one semester... the alternative is if this is outside business hours 13:07:53 we can move with the agenda :) 13:07:59 sure 13:08:05 #topic Review of action items from the previous meeting 13:08:06 Yep 13:08:16 see meeting minutes at http://eavesdrop.openstack.org/meetings/training_guides/2016/training_guides.2016-09-26-17.01.html 13:08:23 matjazp: I will look up possible other slots, I'm fine with outside work hours too 13:08:44 ildikov: let's just wait and we'll adapt 13:09:10 For my action on LP, infra team said currently there is storyboard 13:09:12 ianychoi_phone: there is a controversy about that LP vs Storyboard? 13:09:12 matjazp: ack 13:09:42 we should teach what ever is "the ususal" way for most projects 13:09:47 The team said existing both would not be good 13:09:55 matjazp: majority is still using LP 13:10:13 so we should convince infra team to revert to LP 13:10:25 what do you all think? 13:10:26 the plan was a while ago to move to Storyboard, but I haven't heard that the plan would be executed so far 13:10:34 #link https://review.openstack.org/#/c/375834/ 13:10:52 I think the plan is still to move away from LP and use something that's open source 13:11:08 I proposed this as an agenda on the next infra tram irc meeting 13:11:20 Can someone attend the meeting? 13:11:21 so I don't think convincing is an option here, but I can ask where we are with this 13:11:34 ildikov: ok so dillema is: teach what is used by most projects NOW or teach what will (?) be used in the future 13:12:02 a sandbox page would be useful somewhere, maybe at both places as for instance I don't know how storyboard works and would be nice to learn if we have a few projects using that 13:12:23 #link https://wiki.openstack.org/wiki/Meetings/InfraTeamMeeting#Agenda_for_next_meeting 13:12:46 ianychoi_phone: I can attend that 13:13:05 Infra team is pushing towards storyboard for all projects? 13:13:16 matjazp: teach what we have now and that includes Stpryboard, so we should highlight that too 13:13:21 Since the meeting time is 4 am here.. it is difficult for me to attend.. 13:13:26 #action ildikov attends infra team meeting regarding LP vs storyboard 13:13:45 matjazp: this is on-going plan, as what I heard.. 13:14:04 ildikov: we can show both, no problems there, but sandbox can be linked to one or the oher 13:14:05 other 13:14:05 But still current lots of projects use LP.. 13:14:12 (TBH I thought this Storyboard is dead long ago, since it's been pushed for like 1.5 years now, and nothing happened...) 13:14:20 ianychoi_phone: so the point here is that we shouldn't create a sandbox project in LP, right? 13:14:30 kmARC: I got the same feeling 13:14:56 ildikov: yep and also LP vs storyboard 13:15:12 #link https://storyboard.openstack.org/?#!/story/2000734 13:15:30 I briefly summarized possible discussions.. 13:15:50 ok, lets discuss this at the next meeting, after ildikov talks with infra team, ok? 13:15:59 ianychoi_phone: ok, tnx 13:16:06 matjazp: +1 13:16:06 +1 :) 13:16:07 kmARC, matjazp: StoryBoard is not dead (see https://specs.openstack.org/openstack-infra/infra-specs/specs/task-tracker.html for infra's migration plans) 13:16:38 will we have time to adapt the training for either one? or do we just teach LP for Barcelona anyways? 13:16:39 SotK: so is any other project using it besides infra_ 13:16:40 ? 13:16:43 SotK: thanks for the link 13:17:12 AFAIK not yet.. 13:17:50 just infra and some other newly-formed since Austin projects iirc 13:18:25 SotK: so that's why we thought it's dead :-) 13:18:26 new projects are welcome to use it these days (talk to infra) 13:18:26 #action LP vs Storyboard: we discuss about what we will use at the barcelona training at the next meeting 13:18:43 kmARC: yep, it is an understandable conclusion :) 13:18:57 IMO since still lots of projects use LP, LP would be more relevant for upstream training and it is also good to introduce what storyboard is 13:19:36 aggree 13:19:41 ok, we can decide that next week. I hope it will give us enough time to prepare everything for Barcelona 13:19:57 I really hope so 13:20:14 ianychoi_phone: I agree, let's have a longer block on LP and introduce Storyboard too if someone would look into Infra and/or any new projects that are using that 13:20:30 ildikov: you had two action items from last week 13:20:40 doodle is done, obviously 13:21:03 yeap, I haven't talked to kmARC yet, so I'm happy he made it to the meeting :) 13:21:18 kmARC: how is the testing going? 13:22:14 I didn't have time for it, sorry :-( I moved last week. But now it's done, will do my part during this week 13:22:42 kmARC, that's fine and also I have not uploaded any issues on your github T.T 13:22:45 do we ned to publicise this task (testing) more? send mail to the ML, etc? 13:22:55 kmARC: on the last meeting others confirmed that Devstack eats much memory, so I'm not sure how much improvement can be done on that part 13:23:23 ildikov: true... I switched to 6 GB VM because of that 13:24:03 kmARC: what would be great to do is get at least one instance up in DreamCompute 13:24:25 kmARC: just to see how things come together there if people would have issues with a 6GB VM 13:24:35 ildikov: yes, for trainees that will have troubles with their laptop 13:25:03 kmARC: can you by any chance give that one a try too? 13:27:06 damn, my irc client crashed 13:27:26 ildikov: 13:27:27 yes 13:27:33 Hmm.. matjazp, no talk during your crash time :) 13:27:42 matjazp: you didn't miss any message :) 13:27:51 let's make a note on this 13:28:06 #action kmARC tests devstack in a cloud VM 13:28:25 kmARC: coolio, I will contact Stefano to give you access, will add you to the mail 13:28:29 kmARC: tnx!!! 13:28:55 Good :) 13:28:59 #topic Upstream training - review queue 13:29:40 open patches: https://review.openstack.org/#/q/project:openstack/training-guides+status:open,n,z 13:30:58 regarding git review: I use brew to install it... and a lot of other macOS ppl use that too, so maybe we can add this? what do others use (if you use macOS)? 13:31:55 matjazp: I don't use git review, I'm happy with git push... :) 13:32:06 matjazp: but I think brew is quite common 13:32:19 ildikov: hey, that is not what are you teaching to the trainees ;) 13:32:23 I will have my open patch rebased in the next hour or so. 13:32:24 matjazp, I am also revising git-review document, and two reviewers advised me to use another command rather than brew 13:32:25 #link https://review.openstack.org/380964 13:32:43 ianychoi: yes, I saw that, but I'm still wondering abou it 13:33:07 macOS without brew is useless ;) 13:33:16 matjazp: I actually planned to explain them what's the command behind it, sometimes it's good to know as git review tends to swallow error messages... 13:33:54 ildikov: sure, but that could also overload them with detailed info.. be carefult about that 13:34:02 matjazp, is brew a public package manager? 13:34:35 ianychoi: http://brew.sh/ 13:34:53 brew = apt for mac 13:35:31 For me, I do not care either pip or brew.. but some people say that for official documentation, pip is better 13:35:33 it is open source (if that is what are you asking) 13:35:50 I do not have much detail knowledge on the detail reasonings.. 13:36:11 IMO for upstream training, brew can be used 13:36:28 never mind, we can discuss this in the patch comments 13:37:00 it is a bit personal preference, I guess 13:37:30 Then, documenting both brew and pip would be nice for upstream training? 13:37:48 anything that we need to talk about in the review queue? 13:38:13 numbering maybe? 13:38:17 ianychoi: I believe so.. we do have brew in some other places 13:38:31 ildikov: you beat me to it :) 13:38:40 I think it needs to go away 13:38:54 #topic Upstream training - chapter numbering 13:38:57 matjazp, I see.. I will propose a new patch for that :) 13:38:58 I mean the files of the slides are numbered currently and it makes the structure quite inflexible 13:39:14 Cause it's broken IE there was a huge gap in the numbering system and it just leads to more work renaming everytime a new section is added or moved 13:39:28 ildikov: I like Docs solution 13:39:52 we're talking about https://review.openstack.org/#/c/380789/ 13:39:54 #link https://review.openstack.org/#/c/380789/ 13:39:55 matjazp: Docs solution? 13:40:12 matjazp wrote the comment on the review 13:41:09 yes, look at the last comment 13:41:54 Gerrit is slow at least in my browser today, sorry 13:42:15 ildikov: +1 13:42:35 me too infra team needs to reboot gerrit instances.. 13:42:46 matjazp: I like you proposal in general, although it might lead to very long filenames 13:42:52 Grouping is fine I suppose, but the actual numerical system I think is not helpful. 13:43:07 ildikov: not if we're careful 13:43:28 I agree, grouping does not affect flexibility as opposed to numbers 13:43:54 so I'm fine with that direction 13:44:10 I also fear the file names getting long, but we can go with it for now 13:44:12 ok.. I have to upgrade my irc client... sierra does not play nice with it ;) 13:44:57 #info we replace numbering scheme and use terms as grouping chapters together 13:45:37 #link https://blueprints.launchpad.net/openstack-manuals/+spec/consistency-file-rename 13:45:48 Just FYI :) 13:46:15 Since we already use hyphens, it is fine 13:46:38 I am also fine to removing numbers and use some terms as grouping file names.. 13:47:05 Okay. I'll do that today. 13:47:12 #info we prefer hyphens over underbars in file names 13:47:20 cool! 13:47:47 #info file names must not be too long 13:48:18 All noted :) 13:48:23 :) 13:48:30 Cool :) 13:48:38 do we need a hard limit for file name length? I don't like to define too much rules and conventions, and we're a small team so I guess it's not needed 13:49:00 I don't think it needs to be defined ahead of time 13:49:10 Just use your best judgement 13:49:20 diablo_rojo_phon: +1 13:49:32 diablo_rojo_phon, +1 13:49:54 diablo_rojo_phon: I agree, that's why I didn't put it in the info 13:50:03 Cool. 13:50:23 ok, back to the review queue... anything else to discuss? 13:50:49 And to respond to the other comment about changing the how to contribute section. ildikov and I felt that name didn't have anything to do with the real content of the section. 13:51:13 I can change it back for now, but when that section gets updated, the name should get changed. 13:51:53 we can do it in a later patch 13:51:59 ildikov, "Administrivia" would be better term for 'how to contribute'? 13:52:05 I prefer smaller patches anyway :) 13:52:14 +1 as matjazp 13:52:34 ianychoi: the name 'How to contribute' indicates that we will talk about the contribution process 13:52:41 Okay that's fine. 13:52:46 it also sometimes needlessly blocks a whole patch 13:52:49 ildikov: +1 13:53:02 ianychoi: that slide has nothing to do with that it only guides through the Foundation registration and corresponding items 13:53:16 And the CLA 13:53:24 ildikov: but you must do that before you can proceed 13:54:07 ildikov: so I guess it's debatable if this should be a part of the "contributing process" or not 13:54:11 ildikov, okay. then another term such as 'Participation with identities'? 13:54:12 matjazp: yes, but it's still not the "How" to contribute part, but the administration/prerequisites 13:54:25 Or 'Identify yourself'? 13:54:29 What if we rename it to Contribution bootstrapping or something like this? 13:54:44 csatari: better term, yes 13:54:54 To indicate, that this is not about the contribution itself, but about the first steps. 13:54:55 or requirements 13:55:15 Contribution requirements 13:55:15 I like Administrativa TBH :) 13:55:33 ildikov: same lol 13:55:41 All encompassing and just one word. 13:55:54 But it is not for admistrative purposes.. isn't it? 13:56:00 It is. 13:56:40 ianychoi: it actually is from practical PoV 13:56:44 huh.. 4 min left 13:56:52 The CLA and registration with the foundation is all administration stuff that doesn't really have a lot to do with direct contributions, just being recognized and allowed to contribute. Like being registered to vote. 13:56:58 just submit a patch and we can discuss this there 13:57:01 In my understanding angway 13:57:20 Okay. I'll just change it back for now in this patch. 13:57:20 #topic aob 13:57:26 ok, let's move this discussion to Gerrit, we will not decide it here 13:57:30 anything else? 13:57:33 2 min 13:57:41 ildikov, diablo_rojo_phon okay. It may be because English is not my first language... thanks 13:58:05 we added a few notes to the main etherpad with diablo_rojo_phon: https://etherpad.openstack.org/p/upstream-university-improvements 13:58:27 #info https://etherpad.openstack.org/p/upstream-university-improvements 13:58:35 Oh I will see them 13:58:37 #undo 13:58:38 Removing item from minutes: 13:58:39 ianychoi: no worries :) We can discuss it in a different patch. 13:58:44 #link https://etherpad.openstack.org/p/upstream-university-improvements 13:58:51 diablo_rojo_phon, thanks :) 13:58:52 we're still looking for exercise ideas, so if anyone has add it either to the etherpad or upload it in a patch as a content update 13:59:14 ok, time's up 13:59:23 thanks for participating 13:59:23 okay 13:59:27 thanks all today! 13:59:28 tnx 13:59:29 see you all next week 13:59:33 bye! 13:59:40 see you next week! 13:59:56 bye 13:59:58 bye 14:00:08 #endmeeting