16:00:39 <samccann> #startmeeting Documentation Working Group aka DaWGs
16:00:39 <zodbot> Meeting started Tue Jan  3 16:00:39 2023 UTC.
16:00:39 <zodbot> This meeting is logged and archived in a public location.
16:00:39 <zodbot> The chair is samccann. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
16:00:39 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
16:00:39 <zodbot> The meeting name has been set to 'documentation_working_group_aka_dawgs'
16:01:12 <samccann> @room Meeting time! Who is here to talk the docs?
16:01:13 <oranod> o/
16:01:13 <samccann> Raise your ascii hand (o/) to say hi or any other way you want to let us know you are here. And Welcome to any new folks!
16:01:14 <samccann> #chair Don Naro
16:01:14 <zodbot> Current chairs: Don Naro samccann
16:01:19 <samccann> hey and we will even have meeting minutes tthis time!
16:01:21 <briantist> o/
16:01:38 <samccann> To any newcomers - again, welcome. We chair all attendees as a way of recognizing your time spent here. And it opens it up for people to add to the meeting minutes with commands like #info or #link (to add a link)
16:01:38 <tremble> o/
16:01:41 <samccann> #chair briantist tremble
16:01:41 <zodbot> Current chairs: Don Naro briantist samccann tremble
16:01:57 <samccann> General run of the meeting - We go over action items, give docs updates.. maybe have a topic or two, and go over doctooling updates (all the fun stuff behind the scenes that get us docs.ansible.com!)
16:02:09 <samccann> felixfontein: around to talk docs today?
16:02:16 <samccann> Official agenda is https://github.com/ansible/community/issues/678
16:02:27 <samccann> notice it's a new agenda link for the new year ^^^
16:03:03 <samccann> speaking of which...
16:03:04 <samccann> #action samccann to change ...something... so autobot messages on docs issues point to new agenda.
16:03:09 <samccann> #topic Action Item updates:
16:03:26 <samccann> #info open - oraNod - to look into getting community maintainer(s) for the sphinx ansible theme
16:03:36 <samccann> I think that's still open, right Don Naro ?
16:04:26 <oranod> I think so. honestly struggling to get my brain back to 100% on everything
16:06:53 <samccann> yeah same here.
16:06:54 <oranod> is there an issue associated with that one?
16:06:54 <samccann> no just an action item. Can you open an issue on the community project for that one pls?
16:06:55 <oranod> yeah, that'll be better so we can track it
16:06:56 <samccann> https://github.com/ansible-community/community-team/issues/
16:06:56 <samccann> yeah, I need to stop depending on action items in meeting minutes lol. thanks
16:06:57 <samccann> #info open - samccann flesh out the personas by completing the todo items and putting them in a detailed slidedeck that describes each.
16:07:10 <samccann> I don't think felixfontein is around and I lost track so will just include this as an info so we don't forget -
16:07:11 <felixfontein> o/
16:07:20 <felixfontein> sorry, got a bit sidetracked...
16:07:23 <samccann> #info open ansible/ansible docs issue to add links to the new collection envvar index page after the next antsibull-docs release
16:07:24 <samccann> oh haha...
16:07:26 <samccann> #chair felixfontein
16:07:26 <zodbot> Current chairs: Don Naro briantist felixfontein samccann tremble
16:08:27 <felixfontein> yeah, I still plan to create a PR for that :)
16:08:48 * samccann just spilled water over her keyboard
16:08:49 * samccann can't find the dang cloth she keeps around for just such an occurance... brb
16:09:21 <samccann> 7c
16:09:23 <samccann> woopsie
16:09:34 <samccann> ok back in action... if a little keyboard ..misty
16:09:48 <felixfontein> wb :)
16:09:50 <samccann> ok thanks felixfontein
16:10:01 <felixfontein> at least it's only water, sticky liquids are worse
16:10:08 <samccann> heh new year starting off w/ a bang
16:11:18 <felixfontein> I tried something during the winter break: https://github.com/ansible-community/antsibull-docs/pull/90 - this PR shows the callback type on a callback plugin's page, and provides indexes of callback plugins by type
16:11:20 <samccann> so very true
16:11:20 <oranod> lol I spilled a jar of honey all over my keyboard brb
16:11:21 <samccann> heh
16:11:54 <samccann> #info feedback wanted on https://github.com/ansible-community/antsibull-docs/pull/90
16:12:37 <samccann> cool that looks good!
16:14:21 <felixfontein> what I mainly was wondering about is what's actually the difference between notification and aggregate callbacks, I couldn't find anything on that in the docs (or in the code). I think from ansible-core's point of view it doesn't distinguish between these two types
16:14:25 <samccann> I'll poke around a bit after the meeting but so far looks great
16:14:26 <samccann> #topic doctools
16:14:26 <samccann> since that's what we're talkingabout
16:17:49 <felixfontein> if anyone has better ideas for the text / section in serted in the callback plugin docs page for every callback type, please add suggestions to the PR :)
16:17:51 <samccann> so are you wondering if it's worth distinguishing them in the index pages?
16:18:29 <felixfontein> I think distinguishing them makes sense, but we should really document somewhere what these types mean
16:18:43 <felixfontein> bcoca: do you happen to know?
16:18:54 <felixfontein> (if you are around...)
16:19:25 * bcoca injects more coffee in IV
16:20:28 <bcoca> aside from 'stdout' most of the other types of callbacks wil lnot affect core code are are more 'informational' , notification was supposed to be for callbacks that 'notify other systems/apps/apis' while aggregate are those that add info to sdtout one
16:20:50 <felixfontein> ah, good to know
16:20:50 <bcoca> all documented in my head ....
16:20:53 <felixfontein> :)
16:20:59 <bcoca> yeah, is hould write it up
16:21:05 <bcoca> and let people add other types
16:21:13 <felixfontein> I'll probably create a PR for ansible-core docs to add that, I will ping you and the docs team for it
16:21:26 <bcoca> works4me!
16:21:34 <samccann> #action write up what  the different types of callback mean. aka notification was supposed to be for callbacks that 'notify other systems/apps/apis' while aggregate are those that add info to sdtout one
16:21:35 <felixfontein> right now no other types are allowed (ansible-test validate-modules and antsibull-docs only allow these three)
16:21:51 <samccann> cool thanks felixfontein !
16:21:55 <bcoca> i was expecint the types to grow .. but seems my initial set just was enough for all
16:22:47 <bcoca> i've seen a couple of callbacks that could be called diff types (like one that gets kerberos ticket to inject into winrm)
16:24:16 <felixfontein> maybe we should at least add another category 'other', and add more when explicitly requested?
16:25:33 <bcoca> idk, we should discuss that as it's own followup ... its been a long time and no one requested (but also not documented/explained anywhere ....)
16:26:27 <felixfontein> I agree on that being a followup
16:29:09 <samccann> ok are there other doctools topics today? briantist did I see a PR from you in the scrollback about..erm.. something_init?
16:29:43 <briantist> samccann: yeah felixfontein already addressed it :)
16:29:50 <samccann> woot!
16:30:02 <samccann> okay anything else in docstools land to chat about?
16:30:05 <briantist> it was about `antsibull-docs sphinx-init` and the generated bash script not hardcoding the path 🙌
16:30:22 <samccann> coolness
16:32:35 <samccann> #topic Documentation updates
16:32:38 <samccann> erm.. not that I can remember anything.
16:33:08 <samccann> We have the usual stuff - personas, archiving old docs, plots and schemes to take over the universe one docsite at a time... etc
16:33:23 <samccann> #info looking for feedback on how to open up the docs publishing pipeline - https://github.com/ansible-community/community-topics/issues/174
16:34:05 <samccann> oh.. and there's a contributor summit coming up? Did I see that message fly by somewheres??
16:34:38 <oranod> yeah I think cybette mentioned that in a different chat
16:34:43 <samccann> ah here we go - https://hackmd.io/@ansible-community/cs202302-planning
16:34:53 <samccann> And felix and Briantist are already there...woot!
16:35:35 <samccann> Don Naro: we should think Deep Thoughts (tm) about if there's something we want  to present as well.
16:35:57 <samccann> Like is that a good time to do a show n tell on the proposed personas (assuming I flesh out the details more by then?)
16:36:52 <oranod> I think that would be a good time to get into those details + how the personas tie into the docsite revamp that I mentioned before the break
16:37:46 <samccann> #action samccann dnaro - to figure out a discussion or two for Contrib summit on personas and docsite revamp
16:38:07 <oranod> samccann: by any chance have you noticed this issue yet? https://github.com/ansible/ansible/issues/79645
16:39:45 <oranod> I was looking at it and thinking about how to respond with something along the lines of "we've got several efforts underway to better connect users with content in the docs"
16:40:02 <oranod> not sure I could have phrased things without making it sound too convoluted right now but this issue sort of highlights the need for persona to journey mapping and all that good stuff
16:40:07 <samccann> well on first pass - the PR should be on the new public docsite not in ansible/ansible if I'm reading it correctly
16:40:23 <oranod> yeah there is that too
16:41:13 <oranod> anyway I'm probably derailing things a bit. yeah, I think it'd be great to have some of the efforts we've been discussing at the summit.
16:41:56 <oranod> I def want to use the opportunity to make sure things align with community needs too
16:41:57 <samccann> nah not derailing at all. It's good to highlight important/interesting issues or PRs here.
16:42:17 <samccann> I'll work on moving the issue to the docsite repo. I 'think' there might be some automagic way to do that in github since they are both under the ansible org
16:42:50 <samccann> #topic OpenFloor
16:43:03 <samccann> This is the time to bring up anything docs related that's on your mind...
16:48:55 <samccann> ok things a bit quiet as we all get back into the groove in this glorious new year
16:48:56 <samccann> I'll end the meeting if no one else has a topic today
16:48:57 <oranod> nothing from me. I need to detox a bit more before I can really get docs back on my mind.
16:49:11 <oranod> and get stronger coffee
16:49:11 * samccann wonders how much 🥃caused that need to detox
16:49:19 <samccann> ;-)
16:49:32 * samccann realizes that little jab is now in the official meeting logs for posterity
16:51:57 <oranod> lol. no offence taken. there was booze involved but I was mostly talking about all the food.
16:51:58 <samccann> heh
16:51:58 <samccann> #endmeeting