documentation_working_group_aka_dawgs
LOGS
15:00:08 <oranod> #startmeeting Documentation Working Group aka DaWGs
15:00:08 <zodbot> Meeting started Tue Jul  4 15:00:08 2023 UTC.
15:00:08 <zodbot> This meeting is logged and archived in a public location.
15:00:08 <zodbot> The chair is oranod. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
15:00:08 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
15:00:08 <zodbot> The meeting name has been set to 'documentation_working_group_aka_dawgs'
15:00:19 <oranod> @room Meeting time! Who is here to talk the docs?
15:00:35 <oranod> it'll probably be quiet enough in here with the 4th of July
15:00:41 <sutapa_bhattacha> o/
15:00:44 <oranod> samccann: is out on PTO so just me for now
15:00:45 <anwesha[m]> Hello
15:00:53 <oranod> hi sutapa_bhattacharjee and anwesha
15:01:01 <oranod> #chair sutapa_bhattacharjee anwesha
15:01:01 <zodbot> Current chairs: anwesha oranod sutapa_bhattacharjee
15:01:19 <oranod> #topic documentation work
15:02:17 <oranod> I think the main thing to mention this week is about the lift and shift
15:02:21 <oranod> #link https://github.com/ansible-community/community-topics/issues/243
15:02:58 <oranod> #info we've agreed on July 10th as the date for the split from ansible/ansible to ansible/ansible-documentation
15:04:08 <oranod> #info after the split occurs all docs and example directories will no longer be present in ansible/ansible (this PR: https://github.com/ansible/ansible/pull/81011)
15:04:39 <oranod> #info currently working my way through the to do checklist here: https://hackmd.io/@ansible-community/rkzSKCEvh#To-do-before-split
15:05:15 <oranod> pretty much done with everything there, just waiting on folks to return from bbq and fireworks to merge stuff
15:06:13 <oranod> one interesting point that came up in this meeting previously is about agreeing on some kind of review process and trying to reduce overhead of a separate PR
15:06:27 <oranod> #link https://github.com/ansible/ansible-documentation/issues/36
15:07:30 <oranod> #info samccann and I have spoken to the core team. I put down some details about how we can reduce contributor overhead. samccann and some of the core folks agreed on an approach to track doc items using a project board
15:09:40 <oranod> #info samccann can get into the nitty gritty details next week but I think it's safe to say we've been discussing the concerns and - fingers crossed - we should be alright. personally I have zero concerns with losing any sort of technical stewardship from core.
15:10:27 <oranod> sutapa_bhattacharjee: is there anything you'd like to talk about today?
15:10:41 <oranod> I assigned that issue for the checklist to you
15:12:12 <sutapa_bhattacha> We haven't received much  feedback relating to this issue. https://github.com/ansible-community/community-topics/issues/232
15:12:44 <sutapa_bhattacha> I've pinged some folks to get their suggestions.
15:13:44 <oranod> ok, great. I know it can be tough getting feedback and suggestions, believe me.
15:13:50 <sutapa_bhattacha> oranod: Yes I'll let you know  if I need help.Thanks.
15:13:52 <oranod> we can put that in the bullhorn
15:14:24 <oranod> and if you don't get much help, feel free to ping either myself or Sandra here and we can always shake the tree
15:14:44 <oranod> you're very welcome sutapa_bhattacharjee ! thanks for taking that one on.
15:15:30 <sutapa_bhattacha> oranod: Thank you 😀
15:16:59 <oranod> #topic docsite updates
15:17:49 <oranod> #info I opened a PR to remove the oldsite toggle from the landing pages on docs.ansible.com
15:18:04 <oranod> #link https://github.com/ansible/jinja-docsite/pull/122
15:18:54 <oranod> I'm also using the quiet time today to bang through a bunch of improvements to the jinja templates in the docsite
15:19:25 <oranod> so hopefully we'll have a cleaned up and easier to update docsite here real soon
15:20:05 <oranod> #topic Getting Started updates
15:20:26 <oranod> why did that topic work but not the docsite updates topic?
15:20:37 <oranod> zodbot works in mysterious ways
15:20:43 <oranod> moving on...
15:21:29 <oranod> #info last week we got a PR merged to simplify getting started to focus a bit more on projects with a single dir structure
15:21:44 <oranod> #link https://github.com/ansible/ansible-documentation/pull/29
15:22:12 <oranod> #link https://docs.ansible.com/ansible/devel/getting_started/index.html
15:22:23 <oranod> #info you can see the changes on devel now
15:23:07 <oranod> #info there is also an ongoing discussion around adding EE docs to getting started
15:23:10 <oranod> #link https://github.com/ansible/ansible-documentation/pull/18
15:24:30 <oranod> #info I've been thinking about it some more and am going to propose that we create an ansible/ecosystem-documentation project where we can document tutorials and how tos for Ansible projects
15:24:56 <oranod> #link pretty much just the details here: https://github.com/ansible/ansible-documentation/pull/18#discussion_r1250599233
15:26:26 <oranod> #info I hope this would help us avoid repeating a similar mistake with ramming too much content into a single doc set
15:26:53 <oranod> I guess we'll see when folks return from PTO
15:27:05 <oranod> might be something to chat about here if anyone has thoughts?
15:30:07 <oranod> if not, that's pretty much all I've got
15:30:12 <oranod> #topic Open Floor
15:30:30 <oranod> has anyone got something they'd like to raise for discussion or chat about?
15:31:15 <oranod> I was thinking it would be quiet today, which is fine. better to keep the meeting going though.
15:34:06 <oranod> ok, guess we'll do a short one and end it here.
15:34:15 <oranod> #endmeeting