Fedoran dokumentaatiotiimi

Fedora Documentation Teamin logo Fedora-tavaramerkillä; kirjan sivut taustalla.

Fedora Documentation Team vastaa docs.fedoraproject.org -sivustolla isännöidyn dokumentaation hallinnasta, kuratoinnista ja julkaisemisesta.

Mitä me teemme

  • Hallinnoi ja kuratoi Docs-aloitussivua

  • ylläpitää Fedora Docs -verkkosivustoa

  • Säilytä julkaisumuistiinpanot

  • ylläpitää dokumentaatiota CI (jatkuva integrointi)

  • Ylläpito ja päivitä yleistä dokumentaatiota

  • kuratoida Quick Docs -dokumentaatiokokoelmaa

Keitä me olemme

Dokumentaatiotiimi on vertaisryhmä, jonka monet jäsenet ovat mukana hyvin eri tavoin. Erityisen tärkeää: Sinun ei tarvitse ryhtyä "jäseneksi" osallistuaksesi dokumentaatioon. Kuka tahansa voi osallistua! Eli pikemminkin päinvastoin: jos lisäät tekstin tai korjauksen, sinusta tulee pohjimmiltaan "vertainen".

And by the way, no special skills are necessary to be able to contribute. There are many ways and options to constructively doing so.

Jos olet kiinnostunut luomaan ja muokkaamaan arvokasta tietoa tai haluat jakaa omaa tietämystäsi ja kokemustasi, älä epäröi liittyä joukkoomme. Äläkä pelkää, että joudut samalla sitoutumaan pitkäaikaisesti. Tunnemme monia erilaisia tapoja ja intensiteettejä osallistua. Katso lisätietoja organisaatiostamme tiedostosta tiimin toimintasuunnitelma.

Hallitus

The Board’s task is to coordinate and organize the work of the documentation team. Current members are

darknao

tekninen avustaja

pbokoc

julkaisutiedotteen vastaava toimittaja ja yleinen avustaja

pboy

content writer and editor

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.

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

https://discussion.fedoraproject.org/tag/docs-team

IRC channel

#fedora-docs on Libera IRC

Matrix room

#docs:fedora.im

Have a look on our working infrastructure

We track work in GitLab.

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.