18:30:09 <pboy> #startmeeting docs
18:30:09 <zodbot> Meeting started Wed May 31 18:30:09 2023 UTC.
18:30:09 <zodbot> This meeting is logged and archived in a public location.
18:30:09 <zodbot> The chair is pboy. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
18:30:09 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
18:30:09 <zodbot> The meeting name has been set to 'docs'
18:30:20 <pboy> #topic Roll call
18:30:28 <pboy> Welcome everyone
18:30:33 <hankuoffroad[m]> .hello hankuoffroad
18:30:34 <zodbot> hankuoffroad[m]: hankuoffroad 'Hank Lee' <allegrovelo@gmail.com>
18:30:41 <pboy> Let's wait some minutes for everyone to show up.
18:31:43 <pboy> Welcome Hank. Let's wait some minutes. Maybe, someone else joins.
18:32:13 <hankuoffroad[m]> yep
18:34:43 <pboy> OK. Hope dies last.
18:34:43 <pboy> Let’s proceed.
18:34:54 <pboy> #topic Agenda
18:35:08 <pboy> #info Action item followup & Announcements
18:35:20 <pboy> #info Discussion and decision of Docs team work plan F39/F40 period
18:35:31 <pboy> #info Open floor
18:35:54 <pboy> #topic 1. Action item followup & Announcements
18:36:11 <pboy> I think, no follow up at the moment, so far as I know.
18:36:26 <pboy> Annything to add or to announce?
18:36:48 <hankuoffroad[m]> no, you can move to the topic
18:36:58 <pboy> #info Currently, there is no open follow up or to announce.
18:37:11 <pboy> topic 2. Discussion and decision of Docs team work plan F39/F40 period
18:37:23 <pboy> #link  https://discussion.fedoraproject.org/t/possible-docs-team-work-plan-for-the-f39-f40-period/81122/33
18:37:46 <pboy> Until now, there seems to be no disagreement.
18:38:41 <pboy> If anyone objects of if there are any doubts, let's discuss now.
18:39:36 <hankuoffroad[m]> Server, CoreOS, IoT, SilverBlue, and Quick Docs - what do we need for the rest of working group?
18:39:54 <hankuoffroad[m]> Quick Docs is clear to me.
18:40:42 <pboy> I think, they use primarily local authoring environment. That works for all of them.
18:41:31 <pboy> And we need Web UI for pagure. None of those is using GitLab repo, as far as I know.
18:42:09 <hankuoffroad[m]> correct, none of docs of working group (editions) use GitLab.
18:42:39 <pboy> So, we can focus in those 2 and postpone GitLab WEB UI until there is a final version.
18:43:05 <hankuoffroad[m]> i understand the item 1.
18:44:10 <hankuoffroad[m]> can we move on to 2?
18:44:35 <pboy> Yes, item 2 of the 5 items proposal.
18:45:12 <pboy> My question is, will you take the lead?
18:45:22 <hankuoffroad[m]> yes
18:45:42 <pboy> hankuoffroad[m]  ++1
18:46:07 <hankuoffroad[m]> put me in. Regarding CTA location and practicalities, I added some comments.
18:46:50 <pboy> Yes, I agree. My compilation were only keywords and examples.
18:47:33 <pboy> Anybody else around here with concerns or comments?
18:48:14 <pboy> Well, I see none, therefore:
18:48:47 <pboy> #agreed hankuoffroad[m] takes the lead of item 2 of the 5 item proposal.
18:49:09 <pboy> And as a postscript:
18:49:43 <pboy> #agreed We agree to item 1 of the 5 item proposal
18:50:31 <hankuoffroad[m]> ok, next?
18:50:37 <pboy> Well, lets proceed with item 3 of the 5 item proposal
18:50:49 <pboy> Any concerns here?
18:51:31 <hankuoffroad[m]> 3 Quick Docs - could you help me understand bit better about each task?
18:52:49 <pboy> As a 1st step I would like to add to every article a category and some tags, and to get rid of the navigation bar. So, everything get's a new look&feel.
18:52:58 <hankuoffroad[m]> 1) conversion of all contributions to the category system: is there automatic conversion by Antora?  2) elimination of the navigation column - is there agreement made? 3) introduction of the new header data - replacing navigation column?? 4) elimination of the partials - why?
18:53:07 <pboy> In a 2nd step I w
18:53:25 <hankuoffroad[m]> pboy: navigation bar on the left?
18:53:25 <pboy> In a 2nd step I qwould update the content.
18:53:41 <pboy> yes, navigation var on the left.
18:54:11 <pboy> I'm not aware of any automation. So it is a one go manual editing.
18:54:13 <hankuoffroad[m]> pboy: oh was there discussion that happened before I became a regular?
18:54:51 <pboy> I think so. It was a discussion initiated by Allan Day.
18:54:58 <pboy> The long term goal:
18:55:05 <hankuoffroad[m]> pboy: oh, did you check with Antora specialsts?
18:55:22 <hankuoffroad[m]> s/specialsts/specialists/
18:55:32 <pboy> Away from the traditional handbook like documentation to short, independent articles.
18:55:59 <hankuoffroad[m]> pboy: does it affect all other working groups like CoreOS docs and so on?
18:56:10 <pboy> hankuoffroad[m] No, I didn't, besides a discussion with darknao.
18:56:24 <pboy> An do, it's just about QUick Docs.
18:56:37 <pboy> s/An no/And no/
18:56:51 <hankuoffroad[m]> pboy: that'll do. no objection from me
18:57:07 <pboy> Ok then:
18:57:38 <hankuoffroad[m]> partials - there are many...are you getting rid of all of them?
18:57:51 <pboy> #agreed We agree about item 3 of the 5 item proposal. pboy will take the lead.
18:58:29 <pboy> Now, coming to item 4 of the 5 item proposal (link at the beginning of this topic)
18:59:20 <hankuoffroad[m]> pboy: wait - about partials, I need your answer
18:59:38 <pboy> Sorry, what was it about partials?
18:59:49 <hankuoffroad[m]> are you getting rid of all of them?
18:59:57 <hankuoffroad[m]> over 100 partials
19:00:42 <pboy> Well, just Quick Docs, I'll reintegrate it into the main text, making it much easier for new contributors. I now, it's a lot.
19:01:09 <pboy> May be it is a step 1a, after we have everything on categories.
19:01:12 <hankuoffroad[m]> ah that's fine now. Yes partials are a pain for me
19:01:24 <hankuoffroad[m]> i can't touch them at all.
19:01:40 <hankuoffroad[m]> pboy: +1
19:02:27 <pboy> It's a boring effort, something for the late evening when you are too exhausted for anything else
19:03:04 <pboy> OK, back to item 4
19:03:15 <pboy> I think, we agree, too?
19:04:01 <pboy> OK, no ob jections.
19:04:11 <pboy> agreed We agree about item 4 of the 5 item proposal. pboy will take the lead.
19:04:16 <hankuoffroad[m]> pboy: yes
19:04:22 <pboy> #agreed We agree about item 4 of the 5 item proposal. pboy will take the lead.
19:04:48 <pboy> Well, last one: item 5 of the 5 item proposal
19:05:17 <hankuoffroad[m]> what is the change you are suggesting for release note?
19:05:32 <pboy> I think, we have no other choice. But we should explicitely decide and inform the community
19:05:51 <hankuoffroad[m]> i vaguely remember you're looking to automate publishing of release note
19:06:25 <pboy> hankuoffroad[m]. Yes, bat I was just the messenger. We discussed it that time and darknao wanted to do the technical side.
19:07:04 <hankuoffroad[m]> ok if my memory serves right, it is technically possible, but darknao needs to write script. correct?
19:07:09 <pboy> and yes: the proposal is to automate the gneration of release note by extracting relevant text from the Change proposal
19:07:38 <hankuoffroad[m]> that's really a step forward.
19:08:01 <pboy> Yes, we need some one with good skills in scripting and wiki technologies
19:08:10 <hankuoffroad[m]> it is worth waiting for, but you could influence dev resources at Flock to prioritize for F39/F40 or F100?
19:08:48 <pboy> A good idea to bring it to flock!
19:09:09 <pboy> Maybe we get ti for 41/42
19:09:14 <hankuoffroad[m]> i guess you're going to Ireland - holiday and Flock to represent Docs?
19:09:29 <pboy> Yes, my wife an me will do so
19:09:50 <pboy> Representing Docs and Server
19:10:07 <hankuoffroad[m]> wow that's family business. That's me only in my family with FOSS blood
19:10:24 <hankuoffroad[m]> pboy: i do admire both
19:10:49 <pboy> Yeah, I'm a lucky guy. :-)
19:11:13 <hankuoffroad[m]> sure you are.
19:11:40 <pboy> Well, I think we are agree, so for the protocol:
19:12:10 <pboy> #agreed We agree about item 5 of the 5 item proposal.
19:12:12 <hankuoffroad[m]> Alles klar
19:12:22 <pboy> +1. :-)
19:12:46 <pboy> 'I think we can proceed with next topic.
19:13:05 <pboy> #topic 3. Open floor
19:13:26 <hankuoffroad[m]> a burning question
19:13:30 <pboy> Regarding release party: I'm nearly done
19:13:45 <pboy> done with the itemihzing and the template.
19:14:08 <pboy> Sorry, we had some server breakdown here and I had to do crisis intervention.
19:14:28 <hankuoffroad[m]> cool, thanks. Because it is my first public appearance representing Docs group, so nervous.
19:14:37 <hankuoffroad[m]> pboy: at work?
19:15:09 <pboy> I'll send you the form about one or two  hour or so after closing out meeting
19:15:19 <hankuoffroad[m]> super
19:16:33 <pboy> Yes, at work. I'm  leader of the IT department of several fresearch institutes (as a side job besides doing research), and we are in the middle of a funding process. Everyone is very nerveous
19:17:05 <hankuoffroad[m]> pboy: that's huge commitment and tricky balance to make.
19:17:11 <pboy> But is done now, everything works again since some hours.
19:18:12 <pboy> Yes, it is. Scientist are a funny and impatient community. I know, I'm one myself. :-)
19:18:36 <hankuoffroad[m]> i know it from my son
19:19:34 <hankuoffroad[m]> pboy: actually impatience goes with passion, too
19:19:45 <pboy> Yes, if you don't know it from the inside, it's hard to grab that athmosphere
19:20:10 <pboy> Well everyone with everything else here?
19:21:22 <pboy> None, so I'll close the meeting.
19:21:37 <pboy> Thanks to every lurker. :-)
19:21:42 <hankuoffroad[m]> great.
19:21:53 <pboy> #endmeeting