15:31:39 #startmeeting Docs Project Meeting 15:31:39 Meeting started Wed Apr 11 15:31:39 2018 UTC. The chair is pbokoc. Information about MeetBot at http://wiki.debian.org/MeetBot. 15:31:39 Useful Commands: #action #agreed #halp #info #idea #link #topic. 15:31:39 The meeting name has been set to 'docs_project_meeting' 15:31:56 #meetingname Fedora Docs 15:31:56 The meeting name has been set to 'fedora_docs' 15:32:03 #topic Roll Call 15:32:11 #chair bexelbie 15:32:11 Current chairs: bexelbie pbokoc 15:32:57 hi 15:33:18 .hello2 15:33:19 x3mboy: x3mboy 'Eduard Lucena' 15:34:00 o/ 15:34:02 .hello 15:34:04 .hello bex 15:34:04 bexelbie: (hello ) -- Alias for "hellomynameis $1". 15:34:07 bexelbie: bex 'Brian (bex) Exelbierd' 15:34:08 thank you for starting pbokoc 15:34:08 .hello 15:34:09 shaunm: (hello ) -- Alias for "hellomynameis $1". 15:35:36 if your fas is the same you can say .hello2 15:35:57 .hello2 15:35:58 pbokoc: pbokoc 'None' 15:36:04 that's right! 15:36:16 alright, I don't think anyone else is showing up 15:36:30 #topic Release Notes 15:37:02 so, I closed the issue that sclark opened asking about branching. There is now a f28 branch, because f28 branched from rawhide as well, so we might as well too 15:37:14 +1 15:37:25 #info Please open any merge requests for F28 release notes against branch "f28" 15:37:58 I also merged outstanding requests that were against master (2 of them) 15:38:27 and I opened an issue to create a template for "blank" relnotes that we'll use in the future after branching 15:38:42 and assigned myself to an issue about the README being outdated 15:38:50 but that's not top priority now, what we really need is 15:39:04 #info Write release notes! Instructions are in issues 15:39:39 bexelbie, by the way, you're the relnotes repo owner. I was wondering, if you go to Settings at https://pagure.io/fedora-docs/release-notes/settings 15:40:09 do you see an option to add a new "issue type"? It's a field you see when creating an issue 15:40:19 * bexelbie goes to look 15:40:57 pbokoc, do you mean the templates? 15:40:59 in relnotes there are currently two available types, "default" and "change". I wanted to add more (we could use one for stuff like the "update readme" thing), but I don't think I have the permissions 15:41:29 bexelbie, I have no idea how the terminology works in pagure. I want a new option in the Type drop-down here: https://pagure.io/fedora-docs/release-notes/new_issue 15:41:35 pbokoc, you should be able to in the templates dir of the issue repo: ssh://git@pagure.io/tickets/fedora-docs/release-notes.git 15:41:40 bexelbie, oh wait, yeah, that's a template 15:41:48 aha! 15:42:03 oh, that's cool 15:42:23 :D 15:42:28 if a bit unfortunately named 15:42:54 alright, in that case we probably don't need a new type since there's no point in templating "housekeeping" issues, but we could use some new tags. I'll think about what exactly 15:43:18 the point is, looking at the current issue list, it's a mess, f28+f29 changes and housekeeping. We're going to need to filter that 15:43:35 anyway, that's it from me for release notes - anyone have anything else? 15:44:57 Yes 15:45:08 me too 15:45:08 On release notes no, sorry 15:45:14 but not on release notes for me 15:45:27 alright, what next - bexelbie, do you want to talk about Antora? 15:45:40 yes 15:45:43 #topic New publishing toolchain 15:45:44 but I can go after x3mlinux 15:45:48 or now .. 15:45:53 So I've been playing with Antora 15:45:53 my bad :D 15:46:03 x3mlinux, are you ok with waiting? 15:46:25 Yes, i am ok 15:46:35 I've had a lot of help from asamalik and some great conversations with rkratky 15:46:43 I have a 50% PoC 15:46:45 https://bex.fedorapeople.org/antora-test/fedora/rawhide/install-guide/index.html 15:46:46 #link https://bex.fedorapeople.org/antora-test/fedora/rawhide/install-guide/index.html 15:46:53 Note: The menus don't work and the UI is wonky 15:46:58 that is why it is 50% :P 15:47:15 if you click in the lower left corner you'll get a weird menu that lets go look at the council docs, and some others 15:47:26 for the install-guide and sysadmin-guide you have multiple versions 15:47:40 I am working on getting some proper designer assistance 15:47:54 my next goals are: 1) Finish up the PoC UI 15:48:15 2) See if we can figure out something better for the Quick Docs (there have been some tweets about this with Antora/MojaveLinux) 15:48:21 3) Get translations working 15:48:24 those are not in priority order 15:48:36 I am continuing to try to work on this during my Fridays 15:49:00 and the door remains open, virtual or otherwise. There isn't much in the way of directed tasks unfortunately so you need to show up wiht an agenda or the willingness to hack around 15:49:05 bexelbie, is there a way for me to look at the backend? I'm assuming it has an interface for managing modules/projects and publishing instead of having to do everything on a command line 15:49:14 What kind of help do you need here? 15:49:48 pbokoc, it is pushed to the my forks of the docs repos in the antora_* branches 15:49:59 also I can walk through it at the beginning of Friday -- that has become a pattern too :) 15:50:23 x3mlinux, mostly people who want to figure out how to make it build things, not writing. So we need folks to explore creating those three priorities. It is some code and some configuration and testing 15:50:37 I am trying hard to NOT write new code, and so far have been successful 15:51:26 Ok, i can look at it on Fridays too 15:51:38 hmpf, mornings really don't work for me 15:51:43 Also, I will try not to touch code 15:51:46 Not yet 15:52:14 x3mlinux, sounds good 15:52:23 pbokoc, it's flexible :) 15:52:33 x3mlinux, if you ahve time friday ping me and I'll turn on a bjn 15:52:40 same for anyone else not local to me 15:52:46 yeah alright, we'll figure something out 15:53:39 that's all I have 15:53:45 #topic Open Floor 15:53:49 x3mlinux, now's your time to shine 15:55:32 I'm looking for a way to make the PR reviews faster 15:55:47 At least for quick-docs 15:56:28 well, I think what's blocking that is people, e.g. me - and there isn't a way around that unless we want to just merge without reviews 15:56:57 I am also a blocker there 15:57:05 I am going to add a PR review session to my friday hacks for this reason 15:57:13 is weekly reviews enough for now? 15:57:20 * bexelbie assumes he will be successful :D 15:57:26 I don't want to say too much but it should get better on my end in about 3 months, but right now, work is crazy and I don't have a whole lot of free time outside work either 15:57:50 Weekly works for me 15:58:04 But maybe we can add more people with rights to merge 15:59:34 sure, but who else is there? I don't necessarily have a problem with giving you permissions x3mlinux, but it's still generally a bad idea for one person to review and merge their own commits 15:59:54 I wonder if sassm would also be good to add 16:00:01 he can't make meetings but he seems active 16:00:06 .members docs 16:00:07 bexelbie: Members of docs: aalam adamwill agent86 alick amani ameesters andrmart anross apbrar atmnpatel averi b00blik balajig8 baltazaar bancinco bbbush +bcotton beckerde @bex bouska bradbailey caillon camberwell chrismurphy chuck ciupicri coffeeking couf cprofitt crantila cspicer dale davidz ddomingo delouw diegobz dmaxel dmparker donnie dsilas elf elladeon erivero eslobodo fab fbolton fozz fweimer gadgetwisdom (3 more messages) 16:00:13 we should probably clean that up 16:00:29 wow, what a blast from the past 16:00:45 "b00blik" :D 16:01:07 also, we're out of time, so why don't we meditate on this in the docs channel 16:01:08 I'll email the list and see about trimming this back 16:01:14 we can also look at adding new folks 16:01:18 +1 16:01:22 pbokoc, I'm not asking for permissiond to review my own changes, I agree with you that this doesn't make sense 16:02:02 x3mlinux, yeah, I understand, but the problem is that we simply don't have many active members, so there isn't really anyone to add to reviewers 16:02:04 anyway 16:02:04 But we are adding more and more PRs and all of them are conflicting because all need to edit the _topic.yaml 16:02:19 oh yeah, that's gonna be fun to solve 16:02:21 anyway 16:02:24 #endmeeting