docs/tickets

Update Introductory Page for Local Authoring #11

New issue

Open

opened 2026-02-24 17:23:11 +00:00 by jflory7 · 3 comments

jflory7 commented

2026-02-24 17:23:11 +00:00

Owner

Summary

Update the "Contributing to Fedora Docs" introductory page to focus primarily on the local authoring workflow to lower the barrier to entry for newcomers.

Background

This issue is Part 1 of 5 in the overarching Ticket #1, which aims to improve and simplify the instructions for the Fedora Local Authoring System. During the February 24, 2026 Docs Team meeting, we agreed that the current "contribution machine" feels too intimidating for newcomers. By breaking this down and focusing on local authoring, we want to make our onboarding experience much more welcoming and accessible.

Details

This is a mentored issue! If you are a newcomer looking to help, please ping @jflory7, @pboy, or @pbokoc in the comments to get started.

To complete this task, please update the Introductory Page with the following:

Revise the "Tools" section to heavily focus on local authoring.
Leave the descriptions of older/other tools in the text, but clearly mark them as "not current" or "outdated".
Update the explanation on how to retrieve a page via the icons on the documentation site.

Outcome

A welcoming, streamlined introductory page that clearly points new contributors toward the recommended local authoring path without overwhelming them with outdated tools.

# Summary Update the "Contributing to Fedora Docs" introductory page to focus primarily on the local authoring workflow to lower the barrier to entry for newcomers. # Background This issue is **Part 1 of 5** in the overarching Ticket #1, which aims to improve and simplify the instructions for the Fedora Local Authoring System. During the [February 24, 2026 Docs Team meeting](https://discussion.fedoraproject.org/t/docs-team-meeting-2026-02-24-simplifying-contributions-and-supporting-new-fedora-users/181834), we agreed that the current "contribution machine" feels too intimidating for newcomers. By breaking this down and focusing on local authoring, we want to make our onboarding experience much more welcoming and accessible. # Details This is a mentored issue! If you are a newcomer looking to help, please ping **@jflory7**, **@pboy**, or **@pbokoc** in the comments to get started. To complete this task, please update the [Introductory Page](https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/) with the following: 1. Revise the "Tools" section to heavily focus on local authoring. 2. Leave the descriptions of older/other tools in the text, but clearly mark them as "not current" or "outdated". 3. Update the explanation on how to retrieve a page via the icons on the documentation site. # Outcome A welcoming, streamlined introductory page that clearly points new contributors toward the recommended local authoring path without overwhelming them with outdated tools.

jflory7 self-assigned this

2026-02-24 17:23:11 +00:00

pbokoc was assigned by jflory7

2026-02-24 17:23:11 +00:00

pboy was assigned by jflory7

2026-02-24 17:23:11 +00:00

jflory7 added a new dependency

2026-02-24 17:40:52 +00:00

#1 Improvement of the instructions for the Fedora Local Authoring System.

jflory7 added the

good first issue

help wanted

labels

2026-02-24 17:54:21 +00:00

egret commented

2026-02-25 19:14:35 +00:00

Member

@jflory7, @pboy, and @pbokoc, keen to help.

jflory7 commented

2026-02-26 09:51:50 +00:00

Author

Owner

Hey @egret, awesome! It would be great if you spent some time working on this one. Do you need any help or pointers on getting started with updating the Introductory Page? Do you have questions that help give you more context before you start revising?