16:01:23 <samccann> #startmeeting Documentation Working Group aka DaWGs
16:01:23 <zodbot> Meeting started Tue Jan 31 16:01:23 2023 UTC.
16:01:23 <zodbot> This meeting is logged and archived in a public location.
16:01:23 <zodbot> The chair is samccann. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
16:01:23 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
16:01:23 <zodbot> The meeting name has been set to 'documentation_working_group_aka_dawgs'
16:01:28 <oranod> o/
16:01:32 * samccann crosses fingers for zodbot
16:01:39 <samccann> .ping
16:01:39 <zodbot> pong
16:01:57 <oranod> get out the chicken bones for zodbot
16:02:01 <samccann> sigh
16:02:07 <samccann> it was working yesterday afternoon!!!
16:02:25 <samccann> either it's napping or gone again
16:02:25 <acozine> o/
16:02:36 <samccann> guess it's manual meeting minutes again today
16:02:37 <acozine> I've got a meeting at the half-hour, but can stay 20 minutes or so
16:02:47 <samccann> #chair acozine Don Naro
16:02:47 <zodbot> Current chairs: Don Naro acozine samccann
16:03:01 <samccann> acozine: anything you want to talk about before you go?
16:03:11 <samccann> @room Meeting time! Who is here to talk the docs?
16:03:23 <acozine> nothing specific on my mind, at least, not that I can think of
16:03:27 <samccann> ok cool
16:03:38 <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:03:55 <samccann> oh there it is!!! yay zodbot!
16:03:57 <oranod> acozine: while you're here would you be interested in taking a look at that github action for publishing the package docs?
16:04:02 <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:04:11 <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:04:25 <samccann> briantist: felixfontein around to talk docs today?
16:04:57 <acozine> Don Naro: sure, where should I look?
16:05:10 <oranod> acozine: https://github.com/ansible/docsite/actions
16:05:38 <samccann> Official agenda is https://github.com/ansible/community/issues/678#issuecomment-1402476070
16:05:59 <felixfontein> samccann: sorry, I'm not really around
16:06:07 <oranod> acozine: samccann: was sorting out a group with permissions. I don't know if that's available yet. I can ping you directly with some more info.
16:07:53 <samccann> Ah sorry. That required an email to some alias or other. Did that yesterday but her permissions haven't been added yet
16:08:10 <samccann> thanks felixfontein
16:08:20 <acozine> Don Naro: sounds good, I can see the job definition at least, and it makes sense so far
16:09:06 <oranod> acozine: ok, hopefully permissions will be sorted soon and you can take a closer look.
16:09:37 <samccann> #topic Action Item updates
16:10:07 <samccann> #info closed  samccann to summarize feedback here and pass it on to devtools team.
16:10:18 <samccann> (for their demo combined docsite)
16:10:40 <samccann> Ends up it's a proof of concept to show they can gather docs from various repos and add them to that site. WIP
16:10:55 <samccann> #info open -Looking for  community maintainer(s) for the sphinx ansible theme
16:10:56 <samccann> Anyone interested, please let us know :-)
16:11:04 <samccann> #info closed  samccann reinvite zodbot when it goes on holiday
16:11:43 <samccann> #info solution to zodbot was to open an issue like this one -https://pagure.io/fedora-infrastructure/issue/11103
16:11:56 <samccann> #info closed samccann to see status of marking some plugins as private - https://github.com/ansible/ansible/pull/79370
16:12:30 <samccann> Sadly, it was eventually blocked.  But we have some followon discussions to determine how we can approach these things better in  the future (including semantic markup etc).
16:12:31 <acozine> re: zodbot, do we have any idea why/how it stops working?
16:13:02 <samccann> acozine: they don't know, but we're not the only ones it happens to
16:13:11 <samccann> #info open oranod to update docs requirements versions before Feb 20
16:13:43 <samccann> oranod: Do you think there's a pending blocker on updating all the docs requirements because the theme doesn't support sphinx 6?
16:15:05 <oranod> samccann: I don't think so. I've honestly not got too far into the docs requirements yet.
16:15:13 <samccann> ok cool
16:15:50 <oranod> it's useful to have the reminder on the date though.
16:16:16 <samccann> yep. my nickel would be testing things sooner in case we do have things that need to be fixed etc
16:16:33 <samccann> what's the equivalent in euro? is it just 5-cents?
16:16:56 <oranod> yeah 5c
16:17:10 <oranod> not sure what that was pre-decimal
16:17:11 <samccann> not as intersting.  Needs to be tuppence or something lol
16:17:16 <samccann> anyway, we digress
16:17:22 <samccann> #topic Documentation updates
16:17:30 <samccann> #info Ansible 8 roadmap up for vote - https://github.com/ansible-community/community-topics/issues/176
16:18:05 <samccann> #info booleans and ansible-lint -need help asking collection owners to implement these. See https://github.com/ansible-community/community-team/issues/60 for list that still needs issues opened on the collection itself.
16:18:28 <samccann> basically, it just means opening an issue on a collection to ssay 'hey - how about using booleans compatibile with ansible lint'
16:18:47 <samccann> but there's 100 collections to get through so if anyone is up for opening some issues, that would be a big help
16:20:10 <acozine> I can do a couple of those this week
16:20:25 <samccann> that would be great, thanks! just check off the collection you opened an issue on in that big checklist
16:20:34 <acozine> will do
16:20:39 <acozine> and with that, I need to hop off
16:20:44 <samccann> ok thanks!
16:20:48 <acozine> thanks everybody, see you back here soon!
16:20:49 <samccann> enjoy meeting land :-)
16:20:54 <acozine> heh, thanks
16:21:06 <samccann> #info Archived 2.6 docs and will put redirects in place next week from the old docs to /latest/ - https://docs.ansible.com/archive/ansible/2.6/
16:21:21 <samccann> #info will likely archive the examples repo as it never got any traction - https://github.com/ansible-community/community-examples/
16:21:29 <samccann> #topic personas and revamping the docsite
16:21:43 <samccann> oranod: any specific updates for this week?
16:21:47 <samccann> or calls for help etc?
16:22:22 <oranod> I'd still encourage folks to take a look if they haven't yet. personas are here: https://hackmd.io/pZb5w5JFRQW3RJ73n23tlw
16:22:43 <oranod> and there has been a lot of good discussion here: https://github.com/ansible-community/community-topics/issues/175
16:22:56 <samccann> #info feedbck wanted - see the docsite personas at https://hackmd.io/pZb5w5JFRQW3RJ73n23tlw
16:22:56 <samccann> #info full discussion at https://github.com/ansible-community/community-topics/issues/175
16:23:09 <samccann> is it up for votes somewhere?
16:23:30 <oranod> yeah I think we might ask the community if it really needs a vote at this stage or not
16:24:14 <oranod> andersson007__: and I were talking about it. votes usually indicate a decision and perhaps our motivation for putting it to a vote was more along the lines of getting an "ack" on the personas
16:24:16 <samccann> vote early... vote often
16:24:25 <samccann> yeah makes sense
16:24:34 <samccann> it's been in the bullhorn right?
16:24:46 <oranod> yep, past two weeks
16:24:59 <samccann> so we probably need a vote at some point
16:25:04 <oranod> #info the jinja docsite is available for review / contribution at https://github.com/ansible/jinja-docsite
16:25:34 <samccann> So that is the 'demo' site right now? For the high-level pages and reader journeys?
16:26:13 <oranod> correct, yeah. the idea is to identify the personas, map their journeys, and then sort of overlay the docsite on those journeys.
16:26:54 <oranod> it might be a bit weird to grok all that so hopefully the "demo" site will help put things into context and give folks something to play around with
16:27:15 <oranod> I'll be curious to hear if people hate it or not
16:27:40 <oranod> I tried to keep things simple and go with something that the community would be comfortable with, python and jinja
16:27:56 <samccann> something i'm unclear about - what do we NEED to vote on (aka what needs Steering Committee approval)?
16:28:25 <samccann> like we didn't vote on revamping the user guides.  lordy knows we had no way to vote when we dumped the current pages up there etc
16:28:40 <samccann> did we vote on the ecosystem pages?
16:28:44 <oranod> no we didn't
16:30:42 <samccann> yeah so that's something we should decide... what if anything here needs an actual vote.  It's not like some other things where we are changing how people contribute or features within the  tools etc
16:30:55 <samccann> so I may have gotten vote-crazy suggesting we needed it.  Dunno
16:31:06 <samccann> discussion and visibility for sure, which you're doing already
16:31:51 <oranod> yeah I thought we could discuss whether those personas actually need a vote tomorrow. after talking with andersson007__ I'm not so sure.
16:33:34 <samccann> yeah I agree.. seems overkill to vote. my vote (teehee) is to just keep the discussions open and the demos etc in the bullhorn etc and act on feedback as needed
16:34:03 <samccann> #topic Open Floor
16:34:11 <samccann> Anything else folks want to discuss about docs today?
16:37:24 <samccann> ok seems like that's a wrap then!
16:37:27 <samccann> #endmeeting