16:00:13 <acozine> #startmeeting Docs Working Group aka DaWGs
16:00:13 <zodbot> Meeting started Tue Jan 19 16:00:13 2021 UTC.
16:00:13 <zodbot> This meeting is logged and archived in a public location.
16:00:13 <zodbot> The chair is acozine. Information about MeetBot at http://wiki.debian.org/MeetBot.
16:00:13 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
16:00:13 <zodbot> The meeting name has been set to 'docs_working_group_aka_dawgs'
16:00:23 <acozine> #topic opening chatter
16:00:30 <bcoca> https://docs.ansible.com/ansible/ < missing index
16:00:38 <samccann> o/
16:00:39 <acozine> #chair lmodemal dmsimard
16:00:39 <zodbot> Current chairs: acozine dmsimard lmodemal
16:00:48 <lmodemal> Hello ALL!
16:00:48 <acozine> #chair bcoca samccann
16:00:48 <zodbot> Current chairs: acozine bcoca dmsimard lmodemal samccann
16:00:58 <samccann> well that's unpleasant.
16:01:11 <acozine> ahhh
16:01:27 <acozine> I bet that's the fallout from the Problematic Too-Broad Redirect being removed
16:01:42 <acozine> that should redirect to docs.ansible.com/ansible/latest/
16:01:59 <felixfontein> hi!
16:02:01 <acozine> thanks bcoca
16:02:04 <acozine> #chair felixfontein
16:02:04 <zodbot> Current chairs: acozine bcoca dmsimard felixfontein lmodemal samccann
16:02:21 <samccann> i think it's a docsite problem yeah. the old docsite uses docs.ansible.com/ansible/index
16:02:22 <bcoca> acozine: sdoran noticed, but reported in slack, i realized your attentino was 'here'
16:02:32 <acozine> heh, yep
16:03:25 <samccann> so we'll make this a quick meeting and then go figure out what's gone wrong
16:03:38 <acozine> who else is around?
16:04:43 * dericcrago waves
16:04:48 <acozine> #chair dericcrago
16:04:48 <zodbot> Current chairs: acozine bcoca dericcrago dmsimard felixfontein lmodemal samccann
16:04:49 <gwmngilfen> o/
16:04:53 <acozine> #chair gwmngilfen
16:04:53 <zodbot> Current chairs: acozine bcoca dericcrago dmsimard felixfontein gwmngilfen lmodemal samccann
16:05:17 <gwmngilfen> "consistent furniture achievement"
16:05:59 <acozine> alongchamps: andersson007_ baptistemm briantist cyberpear madonius join us if you're around
16:06:26 <acozine> heh, we'll vote on upholstery for you next week gwmngilfen
16:06:43 <acozine> so think about whether you prefer floral or stripes
16:06:48 * alongchamps waves
16:06:54 <acozine> #chair alongchamps
16:06:54 <zodbot> Current chairs: acozine alongchamps bcoca dericcrago dmsimard felixfontein gwmngilfen lmodemal samccann
16:07:03 <acozine> good morning/afternoon/evening everyone
16:07:05 <briantist> I'm in multiple work meetings so only kinda here
16:07:27 <bcoca> briantist: that describes 2/3rds of people chaired
16:07:28 <briantist> though I asked this yesterday and it  maybe got lost, just curious: "I just noticed the Japanese (2.9_ja) docs, I'm curious where that content/translation comes from? I didn't really see it in the docsite. Especially interested in the stuff that gets auto-generated from changelog fragments and such."
16:07:29 <acozine> briantist: cool, I won't make you furniture then, though I think today will be a short meeting
16:07:51 <acozine> #topic open floor
16:08:25 <acozine> briantist: the japanese docs are generated by Red Hat's translation team
16:09:06 <acozine> the first translation, the one you see for 2.9, was done very much ad hoc, and lives in a branch outside of the main repo
16:09:53 <samccann> #info no more Thursday supplemental DaWGs meeting. We are implementing the docsite split now and will cover details in Tuesday meetings
16:10:06 <briantist> ah I see, are there any plans for open translation or anything like that?
16:10:08 <acozine> when you say you don't see the translation on the docsite, what do you mean?
16:10:24 <briantist> I meant in the docsite repo
16:10:28 <bcoca> the source
16:10:39 <acozine> oh, in `docs/docsite/rst`
16:10:55 <acozine> yeah, right now it's not there, because it would be a whale of a PR to devel
16:11:22 <acozine> we're looking to formalize the process this year
16:11:33 <briantist> cool, thanks for the info
16:12:39 <acozine> but RH doesn't do open translations, because we have no way to verify that folks aren't making the translated docs incorrect or full of profanities
16:13:20 <acozine> it's unfortunate, but understandable
16:13:29 <briantist> yeah, makes sense
16:14:10 <felixfontein> definitely
16:14:16 * bcoca is pretty sure everyone with a forgein language tatoo has been lied to about the meaning of such tatoo
16:14:27 <samccann> heh
16:14:55 <acozine> Following up on last week, I did not summarize our discussion of the possible uses of the `/docs/` folder in collections and create an issue for tracking ideas. I will get to that this week.
16:15:57 <acozine> heh, yep, anything that's supposed to be "spiritual" is especially suspect
16:16:23 <samccann> #info docsite work is progressing. We will post here when we have test site updates available for review.
16:17:07 <acozine> mmm, we did manage to get the new URL for `/ansible-core/` working, but the content there is no different from the current content at `/ansible/`
16:17:17 <acozine> so there's nothing to review
16:17:22 <acozine> but it's on the test site if anyone is curious
16:18:21 <dmsimard> have a link ?
16:18:44 <acozine> dmsimard: http://docs.testing.ansible.com/ansible-core/2.11/
16:18:49 <acozine> it's quite boring, I'm afriad
16:19:02 <acozine> but it exists, and that's a step in the right direction
16:19:17 <dmsimard> thanks :)
16:19:35 <acozine> remember, SSL is not enabled on the testing site
16:20:19 <acozine> so you can move from the testing site to the production site by deleting `testing` in the URLs, but if you want to move the other direction, you must edit `https` to say `http`
16:20:41 <acozine> someday we will enable SSL on the testing site too
16:20:45 <acozine> but today's not looking good
16:22:52 <abadger1999> o/
16:23:13 <samccann> ok if we don't have urgent business we should end this meeting so we can fix the docsite
16:23:25 <acozine> hi abadger1999!
16:23:42 <abadger1999> bom dia!
16:23:46 <acozine> anybody have stuff they want to bring up?
16:24:02 <acozine> PRs to review, issues to ponder, progress to report, questions to ask?
16:24:51 <dmsimard> Last weekened I mentioned the FQCN abbreviation being used without prior explanation -- should I create an issue so we can improve that in the future ?
16:25:07 <acozine> dmsimard: sounds good
16:25:16 <acozine> you could open a PR to add `FQCN` to the glossary
16:25:26 <acozine> or at least suggest that in the issue
16:25:52 <dmsimard> oh it's not even in the glossary -- I can take that
16:26:02 <samccann> also point to where it is used w/o explanation cuz I know we put in hovers over some of them
16:26:21 <dmsimard> works for me
16:26:28 <acozine> since we don't control which page users see first, we can't do the classic "define it the first time, use the abbreviation thereafter", but if we link to the glossary we can help folks figure it out
16:26:54 <acozine> well, I guess we could define it once on every page . . .
16:26:55 <acozine> erg
16:27:30 <samccann> yeah it is supposed to be defined on every page on first use.
16:27:30 <dmsimard> yeah that wouldn't be very DRY :)
16:27:43 <baptistemm> hello
16:28:20 <acozine> hi baptistemm!
16:28:21 <dmsimard> I was suggesting perhaps an automated tooltip or link through sphinx but I don't know whether it'd be a good idea or if it's even possible :)
16:28:32 <baptistemm> hi acozine and everybody !
16:28:46 <acozine> we're doing a short meeting today, pretty much just open floor
16:28:46 <samccann> yeah we have it as a tooltip in sphinx on some places
16:28:57 <samccann> i'll dig it up and post how here later... after we get the docsite fixed
16:29:03 * samccann fixated on broken docsite
16:29:10 <acozine> that's a good thing
16:29:18 <lmodemal> hello baptistemm
16:29:22 <acozine> fixing the broken docsite is important
16:30:24 <dmsimard> oh actually samccann already added FQCN to glossary https://github.com/ansible/ansible/commit/4aedd1b987150baae4b11200de916c87c53e6d30 but it hasn't made it's way to /latest/ yet: https://docs.ansible.com/ansible/latest/reference_appendices/glossary.html
16:30:30 <acozine> thanks dmsimard for keeping on top of that
16:30:38 <acozine> ah, so we need a backport
16:30:55 <dmsimard> to stable-2.10 ?
16:30:56 <acozine> or it will fix itself when 3.0.0 comes out
16:31:07 <acozine> yeah, if we want it in current latest, backport it to stable-2.10
16:31:17 <dmsimard> ok I'll take care of the backport
16:31:24 <acozine> thanks
16:31:33 <acozine> what else is on people's minds?
16:33:01 <samccann> thanks dmsimard
16:33:17 <samccann> #action dmsimard to backport PR that adds FQCN to glossary
16:33:31 <acozine> hearing no other topics, I think we'll end the official meeting early
16:33:42 <acozine> and turn our attention to regex and redirects
16:33:47 * acozine shudders
16:34:07 <acozine> chat welcome in the channel any time
16:34:58 <acozine> thanks abadger1999 alongchamps baptistemm bcoca dericcrago dmsimard felixfontein gwmngilfen lmodemal samccann
16:35:08 <acozine> #endmeeting