14:31:41 <samccann> #startmeeting Docs Working Group aka DaWGs 14:31:41 <zodbot> Meeting started Tue Dec 17 14:31:41 2019 UTC. 14:31:41 <zodbot> This meeting is logged and archived in a public location. 14:31:41 <zodbot> The chair is samccann. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:31:41 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:31:41 <zodbot> The meeting name has been set to 'docs_working_group_aka_dawgs' 14:31:51 <cbudz> present 14:31:59 <samccann> Who's around on this fine snowing (at least here) Tuesday! 14:32:06 <samccann> Welcome cbduz 14:32:15 <samccann> #chair cbudz 14:32:15 <zodbot> Current chairs: cbudz samccann 14:32:21 <samccann> he'ls if I spell it right ,eh? 14:32:35 <samccann> Got any other fine folk around walking to talk the docs? 14:33:52 <samccann> as I recall, gundalow has meeting conflicts but lurks. abadger1999 cyberpear felixfontein - anyone around? 14:35:09 <samccann> ok you and me cbudz so let's ROCK THE DOCS! 14:35:17 <samccann> #topic Status updates 14:35:49 <samccann> #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 <cbudz> sets status to *rock the rocks* 14:36:34 <cbudz> *docks 14:36:44 <samccann> #link https://docs.ansible.com/ansible/devel/user_guide/index.html 14:36:46 <samccann> heh yep! 14:37:32 <felixfontein> I'm essentially away, but *waves* :) 14:37:35 <samccann> #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 <samccann> :-) 14:38:21 <samccann> #comfycushion felixfontein 14:38:57 * samccann contemplates if I'm forgetting any other status updates 14:39:47 <samccann> oh yeah there's one other not quite docs related but IRC meeting related! 14:41:28 <samccann> 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 <cbudz> that's fantastic 14:41:57 <samccann> #info - python script to turn irc meeting minutes into markdown 14:42:01 <samccann> #link - https://gist.github.com/Qalthos/7d9c8256b7040dba1438172771aea663 14:42:26 <samccann> heh yep, plan on using it after this, thus my overuse of info etc :-) 14:42:52 <samccann> oh yeah one other thing 14:42:52 <cbudz> I wondered about that 14:43:11 <samccann> #info last meeting of the calendar year! Next DaWGs meeting will be in January 14:43:45 <cbudz> Where does the time go?? 14:43:45 <samccann> 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 <samccann> I know right? Another year slips away 14:44:53 <samccann> any other status folks want to share? 14:45:28 <cbudz> I'm finalizing Automation Hub docs. Collecting last round of feedback and preparing to get out the door 14:46:04 <samccann> 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 <samccann> #info Automation Hub docs moving along and will eventually move back upstream to Galaxy docs 14:48:51 <samccann> 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 <samccann> ok moving on... 14:49:17 <samccann> #topic Docs Issues and PRs 14:49:39 <samccann> #info we currently have 226 docs issues open and looking for kind souls to help resolve them 14:50:01 <samccann> #link https://github.com/ansible/ansible/issues?q=is%3Aopen+is%3Aissue+label%3Adocs 14:50:34 <samccann> 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 <samccann> 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 <samccann> 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 <samccann> #info Docs PRs running at 105 today 14:54:41 <samccann> #link https://github.com/ansible/ansible/pulls?q=is%3Aopen+is%3Apr+label%3Adocs 14:55:14 <samccann> #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 <samccann> 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 <samccann> ok now that that desperate plea is out there... moving on 14:57:05 <samccann> #topic Open Floor 14:57:15 <samccann> Anyone got anything they want to chat about? 14:57:37 <samccann> oh someone sked this earlier so gonna blast it into the minutes 14:58:18 <samccann> #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 <samccann> #link https://docs.ansible.com/ansible/latest/community/development_process.html#backport-process 14:59:35 <samccann> anything else on the floor besides two chairs and a comfy cushion? (aka anything else to talk about?) 14:59:56 <cbudz> One q i had re: issues 15:00:00 <cbudz> lemme dig it up 15:00:04 <samccann> k 15:00:44 <cbudz> Ok, here: 15:00:46 <cbudz> https://github.com/ansible/ansible/issues/60282 15:01:03 <cbudz> I'm happy to chip away ta this topic since I've got one foot in this at the moment 15:01:12 <cbudz> not sure if anyone else already in flight with it 15:01:30 * samccann looking 15:02:00 <samccann> go ahead and assign it to yourself and that'll indicate you are working on it. and thanks! 15:02:57 <samccann> 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 <samccann> 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 <samccann> anything else before we close? 15:06:06 <samccann> okay gonna call it. Thanks every one and have a good end of year and saying buh-bye to 2019!! 15:06:32 <samccann> #endmeeting