18:30:46 <pboy> #startmeeting docs
18:30:46 <zodbot> Meeting started Wed Jul 19 18:30:46 2023 UTC.
18:30:46 <zodbot> This meeting is logged and archived in a public location.
18:30:46 <zodbot> The chair is pboy. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
18:30:46 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
18:30:46 <zodbot> The meeting name has been set to 'docs'
18:30:55 <pboy> #topic Roll call
18:31:10 <pboy> Welcome everyone
18:31:23 <pboy> Let's wait some minutes for everyone to show up.
18:34:57 <hankuoffroad[m]> .hello hankuoffroad
18:34:58 <zodbot> hankuoffroad[m]: hankuoffroad 'Hank Lee' <allegrovelo@gmail.com>
18:35:48 <pboy> Hi hankuoffroad[m]  today I wasn't too impatient. :-)
18:36:03 <pboy> firtunaely
18:36:08 <pboy> fortunately
18:36:17 <pboy> me and the typos
18:37:00 <hankuoffroad[m]> pboy: no problem. I came back home early today.
18:37:25 <pboy> Luckely.
18:37:32 <pboy> I think we start now.
18:37:38 <hankuoffroad[m]> sure
18:37:43 <pboy> #topic Agenda
18:37:54 <pboy> #info Action item followup & Announcements
18:38:09 <pboy> #info Tickets review: there is no ticket flagged for the meeting on GitLab.
18:38:26 <pboy> #info There are two tickets flagged for “next meeting” on Quick Docs.
18:38:40 <pboy> #info Quick Docs Improvement: Nominate Quick Docs articles for urgent review
18:38:50 <pboy> #info Role-based call to action: banner on Quick Docs home page
18:38:58 <pboy> #info Open floor
18:39:09 <pboy> #topic 1. Action item followup & Announcements
18:39:27 <pboy> #action still to remove outdated installation guide
18:39:41 <pboy> Nothing to announce from me at the moment
18:40:30 <pboy> Anything to add here?
18:40:40 <hankuoffroad[m]> no, let's carry on
18:40:57 <pboy> #topic 2.  Tickets review gitlab
18:41:07 <pboy> there is no ticket flagged for the meeting on GitLab.
18:41:17 <pboy> Not direkt a ticket, but there is a first cut for automated release notes.
18:41:28 <pboy> which maybe a future issue on gitlab
18:41:45 <pboy> Unfortunately, I didn't manage to have a look at it until now. Anyone did?
18:42:28 <hankuoffroad[m]> pboy: No,
18:42:30 <pboy> Obviously not.
18:42:41 <pboy> topic 3.  Tickets review on Quick Docs
18:42:51 <pboy> First one:
18:43:00 <pboy> #link https://pagure.io/fedora-docs/quick-docs/issue/528
18:43:11 <pboy> let us read some minutes
18:47:45 <pboy> Well, first about partials. Is the article composed of partials? If yes, we should re-integrate the partials. They make editing so much harder.
18:48:39 <hankuoffroad[m]> there are partials in the middle.
18:49:44 <pboy> Well, we should reintegrate them. What do you think?
18:50:36 <pboy> Unless they are really reused. A grep could reveal that information
18:50:55 <hankuoffroad[m]> pboy: Could you explain what reintegration means? You mean inserting paragraphs, instead of partials?
18:51:38 <pboy> I mean to copy the content of the partial into the intended place and then delete the partial.
18:52:04 <pboy> The original intention of the partials didn't make into reality.
18:52:40 <hankuoffroad[m]> pboy: Understand.
18:52:53 <pboy> (The intention was to cooperate between Fedora, RHEL, and CentOS.  But, as Ben told us, it never worked out.)
18:53:13 <pboy> perhaps not never, but in the end it didn't.
18:54:36 <pboy> Well, i think we agree about it?
18:54:41 <hankuoffroad[m]> well, I'm not sure what I could do. The last thing I want is to copy and paste...after all, I lose context on what content needs to be rewritten.
18:55:43 <pboy> Well, I alöready
18:56:11 <pboy> I already did that, ever when I edit a QD file.
18:56:39 <pboy> But I can't do anything until after Flock.
18:57:14 <hankuoffroad[m]> ok then, back to the main point - my suggestions to procedure/steps rewritten and a question on why we need other OSes on the guide?
18:57:49 <pboy> I you review and update an article, loosing the context seems not such a problem, in my experiences.
18:58:26 <hankuoffroad[m]> if possible, we can revisit individual tickets and share opnions on DIscussion. Weekly meeting is not rnough to review all tickets and other topics.
18:58:31 <pboy> Well, I think we want to guide a Windows user to check Fedora, even on a SBC
18:59:56 <pboy> hankuoffroad[m]> yes, but I think, now we should speak about it. And the decision to re-integrate the partials is not just about this article, I think.
19:00:53 <pboy> The Windows part is practically an attempt at "seduction" :-)
19:01:30 <hankuoffroad[m]> could we share an update on Pagure ticket? I feel overwhelmed if everything is discussed on meeting.
19:01:40 <pboy> And I think, this is a general question: Will we enable Windows users to use Fedora as well.
19:02:09 <pboy> Yes we can. I'll start with a comment about the three topics.
19:02:51 <hankuoffroad[m]> we lose focus on the quality and accuracy of Fedora linux installation process, while we try to be friends of other OSes.
19:03:00 <pboy> agreed
19:03:35 <pboy> OK, I can comment about the installer issue as well and we can discuss that off-meeting.
19:03:49 <hankuoffroad[m]> next one is too big to read todaay
19:03:56 <pboy> OK.
19:04:05 <hankuoffroad[m]> can you share your feedback on the ticket?
19:04:19 <pboy> Yes, I will
19:04:56 <pboy> #topic 5. Role-based call to action: banner on Quick Docs home page
19:05:26 <hankuoffroad[m]> ah 'Nominate Quick Docs articles for urgent review' is for Flock?
19:06:04 <hankuoffroad[m]> I wish we spare more time offline to go through Quick Docs tickets..some of them are unattended for months.
19:06:32 <pboy> Yes. I hoped, we would have a summary of the events in advance. So everyone, who plans to attend, could nominate an aricle.
19:07:04 <pboy> It's part of my event description. But there is no publication of the propsals.
19:07:05 <hankuoffroad[m]> to be perfectly honest with you, if feedback is not received for PR/reasoned comments, I'm getting skeptical for more adventurous tasks.
19:07:12 <pboy> At least not until recently
19:07:54 <pboy> You are right, it is an attempt.
19:08:25 <pboy> If someone is planning to attend the session, they have the option.
19:08:37 <hankuoffroad[m]> ok let's move on
19:09:08 <pboy> We are now at topic 5, CTA
19:10:02 <pboy> My question is the 2 lines don't stand out enough.
19:10:19 <pboy> I think, we need 'more design'.  :-)
19:10:20 <hankuoffroad[m]> banner wasn't possible, so the text is placed.
19:11:21 <hankuoffroad[m]> I don't know about mechanics of CSS/Antora. I saw your comment on it. Maybe we can wait for a reply
19:11:27 <pboy> A box or banner below the table of contents is feasible.
19:11:43 <hankuoffroad[m]> pboy: that was a compromise
19:12:38 <pboy> An understanding among different positions.
19:12:58 <pboy> A little bit from everything, so to speak
19:13:52 <hankuoffroad[m]> well if banner is technically not possible (hold the thoughts), that's it.
19:14:57 <pboy> I think, it is technically possible, but is maybe too much work for the current contributors.
19:16:11 <pboy> It's no problem to write a bit of CSS just for the Docs pages with picks up your 2 lines and turns them in a banner, dynamically placed beyond the table of contents.
19:16:32 <pboy> And do leave them off, if the table is longer as the text.
19:16:35 <hankuoffroad[m]> pboy: we could be patient in this case. it is summer and slow season. Time to take a break :)
19:18:25 <pboy> Yeah, of course. When i worked on the new homepage, i produced some CSS that was only applied to the Docs pages. But in he end we didn't use it, because I could polish it before release date.
19:18:41 <pboy> Just to demonstrate, it is possible.
19:19:14 <pboy> Well, I think we are at the end?
19:19:30 <pboy> And we continue on discussion an in the tickets?
19:19:50 <hankuoffroad[m]> yes, all the rest is actively discussed offline.
19:20:01 <hankuoffroad[m]> pboy: which one?
19:20:18 <pboy> What do you mean with which?
19:20:53 <hankuoffroad[m]> ah got it now. agreed.
19:21:13 <pboy> OK. So I close now?
19:21:48 <hankuoffroad[m]> no problem.
19:21:52 <pboy> OK
19:21:57 <pboy> #endmeeting