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