Julkaisutietoihin osallistuminen

Fedoran dokumentaatiotiimi

Tässä osiossa kuvataan, miten voit osallistua Fedora Release Notesiin. Ennen kuin alat noudattaa tätä menettelyä, varmista, että täytät kaikki Prerequisites -kohdassa luetellut vaatimukset.

Julkaisumuistiinpanojen osallistumisprosessi on erillisellä sivulla, koska se eroaa muista Fedora-dokumentaatioista. Jos olet kiinnostunut osallistumaan muihin dokumentteihin, katso asianmukainen sivu.

Julkaisutiedot ovat ainutlaatuisia siinä mielessä, että toisin kuin kaikki muu dokumentaatio, ne on kirjoitettu lähes kokonaan tyhjästä jokaista uutta julkaisua varten, kun taas kaikki muut asiakirjat säilytetään julkaisujen välillä, vain päivitysten kanssa. Tämä tarkoittaa sitä, että jotkin alla olevan menettelyn osat, kuten käytetty git-haara tai aikataulu, muuttuvat jokaisen uuden julkaisun myötä. Ennen kuin aloitat julkaisutietojen kirjoittamisen, katso linkki:https://discussion.fedoraproject.org/tag/docs[%#docs% tag on Fedora Discussion], erityisesti sivupalkki oikealla. Sieltä löydät ajankohtaista tietoa.

Kuinka osallistua Fedoran julkaisumuistiinpanoihin

  1. Tarkista sivupalkki linkistä:https://discussion.fedoraproject.org/tag/docs[Fedora Discussion], ja merkitse muistiin annetut tiedot: Julkaisu, aikataulu, haara ja linkki asiaankuuluvien ongelmien luetteloon.

  2. Valitse yksi tai useampi julkaisun avoimien ja määrittämättömien numeroiden listalta, joihin haluat osallistua.

  3. Avaa jokainen valitsemasi numero ja klikkaa oikealla olevaa Ota -painiketta saadaksesi sen.

    Jos ilmoitat ongelman, mutta myöhemmin huomaat, ettet ehdi saada sitä valmiiksi, poistu asiasta mahdollisimman pian, jotta joku muu voi ottaa sen hoitaakseen.

  4. Löydä tietoa ongelmastasi. Monissa niistä on jo paljon tietoa, erityisesti Wiki-linkissä; jos tarvitset lisää, selvitä, kuka on vastuussa muutoksesta (myös mainittu numerossa linkitetyllä Wiki-sivulla), ja @-mainitse heidät aiheen kommenteissa tai keskustele heidän kanssaan IRC/Matrixissa tai postitse. Muista, että on aina parempi tehdä taustatutkimusta ennen kuin alat kysyä. Huomaa, ettet välttämättä aina saa yhteyttä omistajaan kohtuullisessa ajassa; Siinä tapauksessa tee parhaasi, jos jokin menee pieleen, voimme aina päivittää sen myöhemmin.

  5. Kirjoita julkaisumuistio ongelmasta. Jos et ole varma, miltä julkaisumuistio tarkalleen ottaen näyttää, tutustu linkkiin: previous releases inspiraatiota varten. Emme halua pitkiä, liian teknisiä tekstejä, julkaisumuistiinpanot on yleensä tarkoitettu korostamaan muutoksia, eivät kertomaan, miten jotain käytetään.

  6. Nyt työnkulku jakautuu Pagure-käyttöoikeuksien ja teknisten taitojesi mukaan:

    • Jos osaat käyttää gitiä ja ASCIIDocia, kirjoita julkaisumuistio ja lähetä pull-pyyntö päävarastoa vastaan. Varmista, että avaat pull-pyynnön oikeaa haaraa vastaan, et %main% – katso tämän prosessin ensimmäinen vaihe lisätietoja varten. (%main% -haara toimii vain mallipohjana jokaiselle uudelle julkaisulle, joten siinä on vain tyhjä rakenne ja joitakin sivuja, jotka eivät vaihtele julkaisujen välillä.) Panokseesi pitäisi mennä johonkin tiedostoon %modules/release-notes/pages/%, mikä riippuu tarkalleen muutoksen sisällöstä.

Jos et näe lainkaan kohtaa, johon lisäsit panoksesi, varmista, että se on sisällysluettelossa %modules/release-notes/nav.adoc%.

+ * Jos yllä oleva kuulostaa sinusta hölynpölyltä, se on ihan ok. Lisää vain kommentti tekstisi kanssa numeroon, ja joku merkitsee sen ja lisää lopulliseen dokumenttiin.

Toista yllä oleva niin monessa numerossa kuin haluat.

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