Fedoran dokumentaatiotiimi

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".

Ja muuten, osallistumiseen ei tarvita erityistaitoja. On monia tapoja ja vaihtoehtoja tehdä se rakentavasti.

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

Johtokunnan tehtävänä on koordinoida ja organisoida dokumentaatiotiimin työtä. Nykyiset jäsenet ovat

darknao: tekninen avustaja
pbokoc: julkaisutiedotteen vastaava toimittaja ja yleinen avustaja
pboy: sisällöntuottaja ja toimittaja

Tällä hetkellä olemme pieni mutta tuottelias tiimi. Emmekä välttämättä halua olla pieni tiimi pitkällä aikavälillä. Jos olet kiinnostunut luomaan ja muokkaamaan arvokasta tietoa ja olet valmis sitoutumaan säännölliseen työhön, liity joukkoomme.

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.

Käynnissä olevat työprojektit

Dokumenttiarkistojen migraatio: Olemme parhaillaan siirtämässä kaikkea dokumentaatiotamme pagure git -arkistosta gitlabiin, jotta voimme hyödyntää useita edistyneitä ominaisuuksia. Lead: darknao
Paranna Fedora-dokumenttien yleistä kuratointia: Pidemmän aikavälin työ dokumentaation mukauttamiseksi paremmin Fedora-jakelun nykyiseen rakenteeseen ja sen samanaikaiseksi päivittämiseksi. Johtaja: pboy

Joitakin viimeisimpiä valmistuneita töitä

Toteuta pitkä puuttuvien tietojen hakutoiminto kaikkiin dokumentteihin
Poista vanhat dokumentit hakukoneista
Virtaviivaista edellistä julkaisutiedotetta

Hankkeissa odottavat käyttöönottoa

Avustajien oppaan parantaminen: Tarvitsemme yksityiskohtaisemman kuvauksen kaikista käytettävissä olevista vaihtoehdoista osallistumiseen. Ja saatamme tarvita kattavamman kuvauksen "Pull Request" -työnkulusta, jotta uutta tai muokattua sisältöä saadaan repositorioihimme.
Tyylioppaan kehittäminen: Tällä hetkellä ei ole olemassa tyyliopasta, mikä johtaa epäjohdonmukaiseen typografiaan ja dokumenttiemme epämiellyttävään esitystapaan.
Pikadokumenttien kokoelman kuratointi: Pikadokumentit-osion artikkelit kaipaavat hieman huolenpitoa ja päivitystä.
CentOS:n ja Fedoran dokumentaation yhteistyön mahdollisten synergiavaikutusten tutkiminen: Molemmissa jakeluissa on paljon yhteistä koodia ja useita lähes identtisiä hallintarutiineja. Yhteistyöllä ja toimien koordinoinnilla pitäisi olla mahdollista saavuttaa parannuksia molemmissa dokumentaatioprojekteissa.

Mistä löydän Fedoran dokumentaatiotiimin

Please contact us at any of our communication channels:

Fedoran keskustelufoorumi: https://discussion.fedoraproject.org/tag/docs-team
IRC kanava: #fedora-docs on Libera IRC (largely abandoned)
Matrix huone: #docs:fedora.im
Fortnightly Matrix meeting: Every other Tuesday, 13:00 UTC at #meeting:fedora.im

See Fedocal for up to date info

Tutustu toimivaan infrastruktuuriimme

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.

Jos jaksat lukea tänne asti

Ota meihin yhteyttä jonkin yllä mainituista kanavista kautta. Sinusta voi hyvinkin tulla avulias ja arvostettu tiimimme jäsen. Älä epäröi.

Want to help? Learn how to contribute to Fedora Docs ›