14:32:36 <acozine> #startmeeting Docs Working Group aka DaWGs
14:32:36 <zodbot> Meeting started Tue Aug 20 14:32:36 2019 UTC.
14:32:36 <zodbot> This meeting is logged and archived in a public location.
14:32:36 <zodbot> The chair is acozine. Information about MeetBot at http://wiki.debian.org/MeetBot.
14:32:36 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
14:32:36 <zodbot> The meeting name has been set to 'docs_working_group_aka_dawgs'
14:32:41 <acozine> who's around?
14:32:51 <Xaroth> I'm around, busy, but around
14:32:56 <acozine> #chair samccann gundalow Xaroth
14:32:56 <zodbot> Current chairs: Xaroth acozine gundalow samccann
14:33:07 <acozine> Xaroth: awesome
14:33:19 <acozine> that's kind of how I feel, too
14:33:19 <gundalow> woot
14:33:25 <felixfontein> I'm just looking in from time to time, don't really have time to do a lot :)
14:33:52 <acozine> felixfontein: you do a lot in general :-)
14:33:54 <Xaroth> On the plus side: new project that involves ansible.. On the downside: 20 weeks of work, 7 weeks of deadline :|
14:34:00 <Xaroth> so don't expect too much from me.
14:34:02 <acozine> Xaroth: ouch
14:34:30 * acozine looks for agenda items
14:35:05 <acozine> hm, don't see any official ones
14:35:28 <acozine> after Fest, I'm going to get more organized about agendas and things
14:36:16 <acozine> wow, we're back up to 90 open docs PRs: https://github.com/ansible/ansible/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+label%3Adocs+
14:36:23 <acozine> ah, but a bunch of them a copyright changes
14:36:44 <felixfontein> copyright changes in the sense of: add 2019?
14:36:56 <felixfontein> resmo brought that up this morning (europe) in #ansible-devel
14:36:57 <acozine> I'm not sure - going by the PR titles
14:37:12 <acozine> ah, what was the decision/consensus (if there was one)?
14:37:14 <gundalow> https://github.com/ansible/ansible/pull/60908/files
14:37:25 <gundalow> resmo said:
14:37:25 <gundalow> > I am -1 to update years in copyright headers: the common understanding is the year represents the year of first publishing.
14:37:54 <gundalow> I don't think those PRs add anything
14:37:55 <acozine> gundalow: yes, that's my take too
14:37:57 <acozine> agreed
14:38:20 <felixfontein> 15:27 < ctrufan_> @felixfontein @resmo re: copyright date - the copyright date when there's one is date of first publication, so you generally don't want to change it, but if you have a range it implies date of first publication to latest date of any material in the file.
14:38:23 <samccann> somewhere there is a copyright issue where we've been tracking the details from legal. I'll see if I can find it
14:38:56 <gundalow> acozine: I think https://github.com/ansible/ansible/pull/60918/files is good (expand the diff up to see where they are used
14:38:58 <gundalow> )
14:39:18 <acozine> adding the current year, every year, seems like make-work - we've got enough work without that
14:39:58 <acozine> gundalow: yep, that one's a good change
14:40:05 <acozine> (60918
14:40:30 <acozine> ah, FYI, folks, I'm starting a major overhaul of the User Guide pages
14:40:46 <samccann> this is the copyright issue I was thinking of - https://github.com/ansible/ansible/issues/45989
14:41:49 <acozine> samccann: thanks - maybe today is the day for adding that information to the Dev Guide, or possibly to the Style Guide?
14:41:57 <gundalow> acozine: also good https://github.com/ansible/ansible/pull/60821/files
14:42:13 <acozine> then we can close all those PRs with a link to the issue and to the new docs page
14:42:33 <gundalow> +1 to adding to one or both of dev/style guide and closing those PRs
14:43:21 <acozine> 60821 is the kind of PR I love
14:43:31 <acozine> I wouldn't have found that error in a month of Sundays
14:44:06 <gundalow> likewise
14:44:41 <acozine> heh, since I started trying to think about using less slang and less colloquial language in the docs, I find myself using all kinds of colloquial phrases in other times/places
14:44:58 <samccann> gotta have that outlet :-)
14:44:59 <acozine> I probably haven't said "month of Sundays" in years, but it bubbled up
14:45:36 <gundalow> blue moon
14:45:49 <acozine> 'til the cows come home
14:46:01 <gundalow> I think https://github.com/ansible/ansible/pull/60781/files is also good
14:46:09 <samccann> since I was knee high to a grasshopper
14:46:29 <acozine> heh
14:46:38 <acozine> gundalow: I looked at that one yesterday
14:46:57 <acozine> and I wondered if we have general docs about `args` vs `argv` somewhere
14:47:15 <gundalow> should be in `DOCUMENTATION.options` above
14:47:32 <acozine> ah, okay . . .
14:47:55 <gundalow> (though not checked)
14:48:54 <acozine> yeah, it's there - I still find `When using this syntax, you don't need the "args" block anymore` a bit misleading - if you use `argv` you CANNOT use `args`
14:49:07 <acozine> and vice versa
14:49:53 <acozine> the comment makes it sound like you "don't have to" use them together, rather than you "can't" use them together
14:50:16 <acozine> but the overall intent of the PR is good
14:50:16 <gundalow> ah, that's a fair point.
14:50:16 <gundalow> Yup, needs some more words
14:50:52 <acozine> it's an edited-on-GitHub PR, so I'll probably just pull the branch, update it, and merge
14:51:35 <acozine> reviews on those PRs don't often get much action, I suspect because many of the people who create them don't have the git skills they'd need to make changes on top of their existing edits
14:51:57 <acozine> I'm glad we have a mechanism for them to contribute their knowledge to the docs!
14:54:36 <acozine> okay, merged 60918 and 60821
14:55:36 <gundalow> woot, thanks
14:59:12 <acozine> what else is on people's minds?
15:00:01 <acozine> oh, I was going to post a link to my User Guide updates branch
15:00:03 <gundalow> Fest Fest Fest
15:00:14 <acozine> it's https://github.com/acozine/ansible/tree/user_guide_overhaul if anyone is feeling curious
15:00:43 <samccann> feeling ...FESTive gundalow?
15:00:53 <gundalow> boom boom
15:01:02 <acozine> main goals include putting like content together, adding pages as necessary (for example, we don't have a page about logging, that seems like an oversight)
15:01:20 <acozine> ah, yes, Fest!
15:01:24 <acozine> Fest will be awesome
15:01:31 <acozine> Contributor Summit on Monday
15:01:44 <acozine> Welcome party Monday night
15:02:10 <acozine> Full conference agenda Tuesday, amazing conference party Tuesday night
15:02:17 <acozine> Full conference agenda Wednesday
15:02:31 <acozine> training options Thursday
15:02:35 <acozine> and. . . .
15:02:41 <acozine> Best of All . . .
15:03:00 <acozine> Contributor Central, a new space for developers and contributors of all kinds
15:03:17 <gundalow> \o/
15:03:46 * gundalow has to drop off now
15:03:58 <gundalow> Thanks everybody
15:04:05 <acozine> thanks gundalow!
15:04:07 <Xaroth> o7
15:04:34 <acozine> heh, I know that's a wave, but with a 7 it always makes me think of `007`
15:04:48 <acozine> Bond, Xaroth Bond
15:05:03 <Xaroth> heh
15:05:06 <Xaroth> it's a salute, actually
15:05:16 <acozine> even better!
15:05:17 <Xaroth> something that sticks to you from playing too much EVE >_>
15:05:49 <acozine> heh, thanks for the cultural breacrumb!
15:05:54 <acozine> breadcrumb
15:07:24 <acozine> To register for AnsibleFest 2019: https://ansiblefest.eventcore.com/account/create?sc_cid=701f2000001D9RxAAK
15:08:01 <acozine> that's what's on my mind today
15:08:35 <acozine> anybody have concerns, questions, ideas, suggestions, complaints . . . ?
15:08:39 <acozine> about the docs, that is
15:09:01 <acozine> everybody has concerns, questions, ideas, suggestions, AND complaints, generally speaking
15:10:11 <acozine> going once . . .
15:10:32 <acozine> going twice . . .
15:11:16 <acozine> all right, that's it for another official DaWGs meeting
15:11:42 <acozine> thanks samccann gundalow Xaroth felixfontein and all the lurkers!
15:12:11 <acozine> agenda items welcome for next week (or any week) at https://github.com/ansible/community/issues/389
15:12:50 <acozine> and/or bring stuff up in the chat channel any time
15:12:54 <acozine> thanks again, folks
15:12:56 <acozine> #endmeeting