19:24:59 #startmeeting storyboard 19:25:00 Meeting started Wed Nov 15 19:24:59 2017 UTC and is due to finish in 60 minutes. The chair is SotK. Information about MeetBot at http://wiki.debian.org/MeetBot. 19:25:01 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 19:25:03 The meeting name has been set to 'storyboard' 19:25:31 #link https://wiki.openstack.org/wiki/Meetings/StoryBoard Agenda 19:25:44 somewhat outdated because I failed to update it just now 19:25:57 #topic In Progress Work 19:26:33 I sent a patch to replace marked with markdown-it, since the latter is actually maintained 19:26:59 #link https://review.openstack.org/#/c/518625/ 19:27:06 oh no I was typing the link! :D 19:27:22 yes that is on my todo list for reviewing this week, please poke me if I don't get to it by fri 19:27:37 ok then, thanks 19:27:57 I was going to check the js draft build, but that's currently broken, SotK sent a patch to fix the issue: 19:28:00 #link https://review.openstack.org/#/c/518626/ 19:28:16 in general that will make it quicker to review webclient patches again 19:28:23 i've definitely been slow on those 19:28:28 thanks for the review fungi :) 19:28:32 I'll reply on gerrit later 19:29:22 this is still hovering: 19:29:25 #link https://review.openstack.org/#/c/506812/ 19:30:05 my current position is that I want it merged in some form before the next team is ready to migrate, even though I'd rather a cgit link 19:30:29 since I think their need for the info will outweigh the other considerations there 19:31:23 * SotK agrees with fungi's comment, but can see the need to have it merged in some form soon 19:31:57 yeah, I haven't seen a lot of movement on it in the release team, though I agree that'd be best 19:32:07 not sure who the best person would be to ask about that 19:32:26 well, also relevant is smcginnis's comment, wherein he points out that the releases repo readme is not intended as a reference 19:33:12 so sort of like calling private methods in a library, it's subject to being broken at a moment's notice 19:34:13 i'm inclined to consider heavily any comment from the release ptl stating that the releases repo readme isn't a reference 19:35:01 it would probably help to follow up and find out whether that section should be relocated to something published to the releases site or the project teams guide 19:36:18 sure, it would be better if we could get it documented somewhere more permanent 19:36:26 that seems likely to be the best way to making it into something mergable I think 19:36:53 to be clear, I can see the need to have it merged, but I don't want to merge it as-is 19:37:03 I still generally lean toward preferring a liable-to-break reference over none, but I don't want to cause trouble for the releases team 19:37:25 if the worry is that people will complain to them should it get broken when they didn't make a guarantee of supporting it 19:38:15 i'm mostly just not keen to have official documentation linking to something the release managers don't want linked as documentation 19:38:57 if for no other reason than it's best not to get on their bad side ;) 19:39:35 Hey, just reading scrollback and trying to remember that patch... 19:39:36 oh sure, I don't want to tread on toes. :D I just foresee us ending up making some other even more unofficial documentation otherwise 19:40:13 So I'm OK with linking to the README. Just think it might be good if we documented that somewhere better. 19:40:26 (we already have a bad habit of leaving doclike things in paste.openstack.org too long) 19:40:49 To be fair, the README isn't likely to change, so it would be safe enough. 19:41:09 if there's a better option I could make a patch for it, not sure where would be best? 19:41:45 Zara: I think it might be best to add a section to the release-management section of the project team guide. 19:42:02 okay :) 19:42:50 it's partly been stuck so long because I've been pretty distracted so I think it's on me to get it moving 19:43:31 right, the other (related) concern with 506812 is that if the sb docs _do_ link to the readme then what's actually desired is linking to a section heading of an html-rendered version of the wiki, and the proposed patch attempts to abuse github's interface to that end 19:43:56 er, s/wiki/readme/ 19:44:12 * fungi has wikibrain at the moment apparently 19:44:16 :D 19:45:18 my brain is fried, sorry. I see now that that doesn't seem to have section headings yet? (the project team guide) 19:45:23 well, linkable ones 19:45:23 at any rate, i similarly don't want to be linking to gh copies of openstack repos, nor treating it as a makeshift documentation publishing platform 19:45:59 +1 19:46:01 Zara: which page are you looking at? 19:46:55 if you hover over a subheading in a page you should see a paragraph mark appear to the right which is clickable 19:46:57 oh I was failing to use dashes instead of underscores 19:47:05 I didn't see the paragraph mark but they do have ids 19:47:22 I was looking at: https://docs.openstack.org/project-team-guide/release-management.html 19:47:32 and saw no paragraph mark, but source suggests it has ids so ignore me 19:47:46 hm, I see the paragraph mark on that page 19:48:07 you have to hover to the immediate right of the end of the heading for the ΒΆ to appear 19:48:37 basically a hidden character that changes to a visible color on hover 19:48:49 aha my mouse was too far to the right 19:49:07 secret sphinx features ;) 19:49:36 :) 19:50:00 either I've used it before somewhere but with a wider area or I'm imagining that 19:50:18 anyway, I will be happy to +2 a patch which links to the needed content on that page 19:51:08 cool 19:51:21 but likely will not +2 a patch which links to github in the meantime, since I don't want to forget about it 19:51:34 similarly, i'll be happy to +2 the corresponding addition to the project team guide 19:52:26 \o/ 19:52:27 thanks 19:52:36 now I just have to do things 19:52:40 thanks fungi and Zara 19:52:48 (and smcginnis) 19:52:53 so many things 19:53:47 anything else in progress that needs discussion? 19:54:43 #topic Open Discussion 19:57:56 oh, https://review.openstack.org/#/c/510669/ is still in review 19:57:59 I completely forgot about that 19:58:11 (docs on manually upgrading a sb instance) 19:58:36 heh, me too 19:58:41 :D 19:58:44 do you have time to add that to your list? 20:00:03 -> #storyboard 20:00:05 #endmeeting