14:31:41 #startmeeting Docs Working Group aka DaWGs 14:31:41 Meeting started Tue Dec 17 14:31:41 2019 UTC. 14:31:41 This meeting is logged and archived in a public location. 14:31:41 The chair is samccann. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:31:41 Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:31:41 The meeting name has been set to 'docs_working_group_aka_dawgs' 14:31:51 present 14:31:59 Who's around on this fine snowing (at least here) Tuesday! 14:32:06 Welcome cbduz 14:32:15 #chair cbudz 14:32:15 Current chairs: cbudz samccann 14:32:21 he'ls if I spell it right ,eh? 14:32:35 Got any other fine folk around walking to talk the docs? 14:33:52 as I recall, gundalow has meeting conflicts but lurks. abadger1999 cyberpear felixfontein - anyone around? 14:35:09 ok you and me cbudz so let's ROCK THE DOCS! 14:35:17 #topic Status updates 14:35:49 #info part 2 of the User Guide overhaul is out and published on devel. Comments always welcome. More improvements to come (thanks acozine !!) 14:36:27 sets status to *rock the rocks* 14:36:34 *docks 14:36:44 #link https://docs.ansible.com/ansible/devel/user_guide/index.html 14:36:46 heh yep! 14:37:32 I'm essentially away, but *waves* :) 14:37:35 #info still poking away at triming down site search to one option on docs.ansible.com/ansible. Currently there are two. 14:37:52 * samccann contemplates tossing furniture at felixfontein anyway 14:37:56 :-) 14:38:21 #comfycushion felixfontein 14:38:57 * samccann contemplates if I'm forgetting any other status updates 14:39:47 oh yeah there's one other not quite docs related but IRC meeting related! 14:41:28 Qualthos wrote a nifty python script that scrapes meeting minutes in IRC and turns them into markdown to help update meeting minutes on the ansible wikis 14:41:50 that's fantastic 14:41:57 #info - python script to turn irc meeting minutes into markdown 14:42:01 #link - https://gist.github.com/Qalthos/7d9c8256b7040dba1438172771aea663 14:42:26 heh yep, plan on using it after this, thus my overuse of info etc :-) 14:42:52 oh yeah one other thing 14:42:52 I wondered about that 14:43:11 #info last meeting of the calendar year! Next DaWGs meeting will be in January 14:43:45 Where does the time go?? 14:43:45 yeah, might be overkill on the infos but we'll see once I run the script. it's a learning process for sure but will still be v. spiffy to have easy to read minutes right in the agendas 14:44:08 I know right? Another year slips away 14:44:53 any other status folks want to share? 14:45:28 I'm finalizing Automation Hub docs. Collecting last round of feedback and preparing to get out the door 14:46:04 kewl! For those reading along, Automation Hub is the downstream version of Galaxy. So what cbudz is doing will eventually move upstream as well to improve Galaxy docs! 14:46:36 #info Automation Hub docs moving along and will eventually move back upstream to Galaxy docs 14:48:51 oh the other thing I did, which doesn't warrant an info is I updated swiftype metdata in all the maintained ansible docs versions. We had the metadata there, but in the joy of copy/paste, it had some old tower release version listed. (aka we hadn't a clue what we were copying at the time) 14:49:09 ok moving on... 14:49:17 #topic Docs Issues and PRs 14:49:39 #info we currently have 226 docs issues open and looking for kind souls to help resolve them 14:50:01 #link https://github.com/ansible/ansible/issues?q=is%3Aopen+is%3Aissue+label%3Adocs 14:50:34 I think we've been hovering around that number for a while now. Would be nice to see it shrinking in the new year. 14:51:44 which reminds me, I think acozine and I formally announced (aka said it here) that we had a new year resolution to close 24 docs issues in 2020! Anyone and everyone else is welcome to play along. I think that's a rate of two a month, but if a few of us did that, we'd really cut down that number I think 14:51:58 * samccann scans list to see how many new issues come in a month... 14:53:00 well we had a lot of new issues this past month, but in general, I think we can whittle down the blacklog with some concerted effort in the new year 14:54:28 #info Docs PRs running at 105 today 14:54:41 #link https://github.com/ansible/ansible/pulls?q=is%3Aopen+is%3Apr+label%3Adocs 14:55:14 #info goal is to get and then keep this down to under 75... any/all help welcome (reviews, comments, approvals etc. Everything helps move them along) 14:55:47 We got behind I think with the run up to the 2.9 release and are still struggling to get that number back down. Sigh. 14:57:00 ok now that that desperate plea is out there... moving on 14:57:05 #topic Open Floor 14:57:15 Anyone got anything they want to chat about? 14:57:37 oh someone sked this earlier so gonna blast it into the minutes 14:58:18 #info documentation for 'devel' is updated/republished nightly to docs.ansible.com. Merged PRs show up there. If the PR should be in 'latest' or some other version, please backport it. 14:58:46 #link https://docs.ansible.com/ansible/latest/community/development_process.html#backport-process 14:59:35 anything else on the floor besides two chairs and a comfy cushion? (aka anything else to talk about?) 14:59:56 One q i had re: issues 15:00:00 lemme dig it up 15:00:04 k 15:00:44 Ok, here: 15:00:46 https://github.com/ansible/ansible/issues/60282 15:01:03 I'm happy to chip away ta this topic since I've got one foot in this at the moment 15:01:12 not sure if anyone else already in flight with it 15:01:30 * samccann looking 15:02:00 go ahead and assign it to yourself and that'll indicate you are working on it. and thanks! 15:02:57 If you fix it in one PR, put 'fixes #60282 in your PR summary. That will automagically close the issue when the PR merges 15:03:33 if you fix in multiple PRs, put 'part of #60282' in each PR until the last one. Then put fixes in it to auto close when the merge is done. 15:04:45 anything else before we close? 15:06:06 okay gonna call it. Thanks every one and have a good end of year and saying buh-bye to 2019!! 15:06:32 #endmeeting