Fedora Documentation Team
The Fedora Documentation Team is responsible for the management, curation, and publishing of the documentation hosted at docs.fedoraproject.org.
What we do
-
manage and curate the docs landing page
-
maintain the Fedora Docs Website
-
maintain the release notes
-
maintain the documentation CI (Continuous Integration)
-
maintain and update generic documentation
-
curate the Quick Docs collection of documentation
Who we are
The documentation team is a peer group with many members involved in very different ways. Especially important: You do not have to become a "member" to contribute to the documentation. Anyone can contribute! So it’s rather the other way around: if you contribute a text or a correction, you basically become a "peer".
And by the way, no special skills are necessary to be able to contribute. There are many ways and options to constructively doing so.
If you are interested in creating and shaping valuable information or would like to share your own knowledge and experience, don’t hesitate to join us. And don’t be afraid that you will have to make a long-term commitment at the same time. We know many different ways and intensities of contributing. See the team charter for information on how we are organized.
The Board
The Board’s task is to coordinate and organize the work of the documentation team. Current members are
Currently, we are a small but productive team. And we don’t necessarily want to be a small team in the long run. If you are interested in creating and shaping valuable information and are willing to make some commitment of regular work, please join us.
How to join the Docs Project
Anyone with a FAS account can open a pull request. However, if you would like to work with us more long-term, or maybe become a maintainer or help us with merging other contributors' pull requests, there is a formal process where you can join the Docs Project.
First, we would appreciate if you came and said hi to us in our Matrix channel, #docs:fedora.im, and made a few contributions to docs. After we get to know you a little bit, you can open an issue in the Tickets repository and use the "New team member request" to nominate yourself. You can also have someone who is already on the team nominate you instead using the same template.
After you or someone else opens that issue, there is a 7 day minimum waiting period during which current team members can vote. A successful nomination requires at least 3 +1 votes and no -1 votes. Negative votes are extremely rare, and are handled on a case by case basis.
Once the nomination gains 3 "yes" votes and a week passes, we will add you to the Docs Team FAS group, which will give you a higher level of access to any docs repositories such as merging pull requests.
Ongoing working projects
- Migration of docs repositories
-
We are currently in the process of moving all our documentaion from the pagure git repository to gitlab, to make use of several advanced features. Lead: darknao
- Improve the overall curation of Fedora docs
-
A longer term work to better adapt the documentation to the current structure of the Fedora distribution and update it at the same time. Lead: pboy
Some most recently finished efforts
-
Implement a long missing search function across all docs
-
Exclude old docs from search engines
-
Streamline previous release note
Projects in the pipeline waiting to be taken up
- Improving the contributors guide
-
We need a more detailed description of all the options available to contribute. And we may need a more extensive description of the “Pull Request” workflow to get new or modified content into our repos.
- Developing a style guide
-
Currently, there is no style guide resulting in an inconsistent typography and unpleasant presentation of our docs.
- Curation of the Quick Docs collection
-
The articles in the Quick Docs section need some care and updating.
- Exploring possible synergy effects of a cooperation between CentOS and Fedora documentation
-
Both distribution share a lot of code and a large number of almost identical administrative routines. It should be possible to achieve improvements for both documentation projects by joint work and coordinating efforts.
Where to find Fedora docs team
Please contact us at any of our communication channels:
- Fedora discussion forum
- IRC channel
-
#fedora-docs on Libera IRC (largely abandoned)
- Matrix room
-
#docs:fedora.im
- Fortnightly Matrix meeting
-
Every other Tuesday, 13:00 UTC at #meeting:fedora.im
See Fedocal for up to date info
Have a look on our working infrastructure
Work is tracked in multiple repositories as relevant. Tickets which affect the project as a whole instead of a specific repository are located in the Tickets repo.
If you managed to read this far
Please contact us using one of the above channels. You are highly ‘suspect’ to become a very helpful and respected member of our team. Don’t hesitate.
Want to help? Learn how to contribute to Fedora Docs ›