docs/tickets

Planning the expansion of the Docs homepage content #6

New issue

Open

opened 2026-01-27 12:10:59 +00:00 by pboy · 5 comments

pboy commented

2026-01-27 12:10:59 +00:00

Owner

A first draft of the expansion is available at https://pboy.fedorapeople.org/draft/.

The basic structure has already been approved in various discussions. It remains to be decided exactly what details should be included.

Currently under discussion are:

join / mentor project
packaging guide
Documentation contributor guide

A first draft of the expansion is available at https://pboy.fedorapeople.org/draft/. The basic structure has already been approved in various discussions. It remains to be decided exactly what details should be included. Currently under discussion are: - join / mentor project - packaging guide - Documentation contributor guide

👍 2

pboy added this to the (deleted) project

2026-01-27 12:11:23 +00:00

perpetrator commented

2026-02-06 20:28:26 +00:00

its good to see someone taking the lead
it's certainly a big area that needs to be looked into.
The first thing that come to my mind looking at the draft is the webpage width.
Modern websites tend to keep it around 1130px for better readability.
It makes it easier to implement for mobile UI and is generally easier on the eyes

That being said, I would like to help in any way I can.

its good to see someone taking the lead it's certainly a big area that needs to be looked into. The first thing that come to my mind looking at the draft is the [webpage width](https://www.untitledsite.co/squarespace-tutorials/best-web-page-width). Modern websites tend to keep it around 1130px for better readability. It makes it easier to implement for mobile UI and is generally easier on the eyes That being said, I would like to help in any way I can.

jflory7 commented

2026-02-06 21:45:40 +00:00

Owner

@perpetrator I think there are two tasks for this ticket:

Reorganizing the content on docs.fp.o to match the draft version on @pboy's Fedora People site.
Fixing UI/UX issues and improving accessibility on the site overall.

I think this ticket is more focused on Task 1, but we could potentially expand the scope to include Task 2. Otherwise, we likely need to open new tickets here to track the general UI/UX work, or work from commops/tickets#71 (which should probably be a ticket over here now anyways).

@perpetrator I think there are two tasks for this ticket: 1. Reorganizing the _content_ on docs.fp.o to match the draft version on @pboy's Fedora People site. 2. Fixing UI/UX issues and improving accessibility on the site overall. I think this ticket is more focused on Task 1, but we could potentially expand the scope to include Task 2. Otherwise, we likely need to open new tickets here to track the general UI/UX work, or work from https://forge.fedoraproject.org/commops/tickets/issues/71 (which should probably be a ticket over here now anyways).

👍 1

jflory7 commented

2026-02-24 15:34:28 +00:00

Owner

Ran out of time to discuss in 2026-02-24 Docs Team meeting.

We did not discuss this ticket in today's meeting, even though it did make the agenda. We encouraged Docs Team members to weigh in asynchronously on this issue.

_Ran out of time to discuss in [2026-02-24 Docs Team meeting](https://discussion.fedoraproject.org/t/docs-team-meeting-2026-02-24-simplifying-contributions-and-supporting-new-fedora-users/181834)_. --- We did not discuss this ticket in today's meeting, even though it did make the agenda. We encouraged Docs Team members to weigh in asynchronously on this issue.

jflory7 added the

good first issue

help wanted

labels

2026-02-24 18:07:45 +00:00

jflory7 added a new dependency

2026-04-01 13:26:16 +00:00

#8 Creating a Beginner's Guide to Fedora

pbokoc added the

labels

2026-05-29 12:25:09 +00:00

egret modified the project from (deleted) to Revamping Docs Homepage

2026-06-03 11:57:04 +00:00

pboy commented

2026-06-28 13:46:45 +00:00

Author

Owner

And – with limited resources in docs – we have to do one step after the next. So I'll open a new tracking ticket for this.

@perpetrator Agreed! But I would like to handle UX / design questions on a separate track. We need a team with a different skill profile for this. And – hopefully – if we exactly know which content to present, the designer can create a more accurate and right to the point graphical design. And – with limited resources in docs – we have to do one step after the next. So I'll open a new tracking ticket for this.

pboy referenced this issue

2026-06-28 14:00:07 +00:00

Planning a more modern design for the Docs homepage #52

pboy commented

2026-06-28 16:13:10 +00:00

Author

Owner

Created a post at Join SIG Matrix room if they want to add something.