Info Draft FLOSS Manuals suomeksi

Johdanto

FLOSS Manuals

FLOSS Manuals tarjoaa avoimia käyttöohjeita vapaiden ohjelmistojen käyttöä varten. FLOSS Manuals on voittoa tuottamaton säätiö, joka on perustettu Amsterdamissa vuonna 2006. FLOSS Manuals on myös wiki ja vapaan dokumentaation kirjoittajien yhteisö.

Lyhenne FLOSS tulee sanoista Free/Libre/Open Source Software. Suomeksi lyhenne käännetään yleensä sanoiksi Vapaat ja Avoimen Lähdekoodin Ohjelmat eli VALO. FLOSS Manualsin voisi siis suomentaa VALO-käyttöohjeiksi.

Kansainvälinen FLOSS Manuals koostuu tällä hetkellä englannin-, suomen-, ranskan-, farsin- ja hollanninkielisestä wikistä sekä käännösvyöhykkeestä, jossa on käännettyjä oppaita monilla eri kielillä.

Suomenkielinen FLOSS Manuals sai alkunsa yhteisöllisen ja osallistavan median Medios-projektissa, jossa se kotoistettiin Suomeen mediakulttuurijärjestö m-cultin toimesta. Suomen FLOSS Manuals avattiin vuonna 2009.

FLOSS Manualsin alustana on Booktype, joka on wikin kaltainen työkalu kirjojen luomiseksi. Booki mahdollistaa kirjojen kirjoittamisen yhteistyössä ja niiden julkaisemisen verkossa, e-kirjana tai painoa varten muotoiltuna PDF-tiedostona. 

FLOSS Manuals on avoin kaikille ja voit osallistua sen toimintaan vaikkapa parantelemalla vanhaa opasta tai kirjoittamalla oman oppaasi. 

 

Mitä teemme 

Vaikka 60% kaikista verkkosivuista toimii vapailla ohjelmilla, miksi vain 1,7% kaikista tietokoneen käyttäjistä on asentanut vapaita ohjelmistoja tietokoneilleen? Vastaus on yksinkertainen. Free Software Foundationin sanoin: 
 
"Suurin vapaiden käyttöjärjestelmien ongelma ei ole ohjelmistojen laatu - se on hyvien vapaiden käyttöohjeiden puute."
 
FLOSS Manuals on olemassa tarjotakseen nämä käyttöohjeet kaikille, ilmaiseksi. 

Teemme tämän verkkosivumme kautta. Verkkosivumme on wiki. FLOSS Manuals ei ehkä muistuta Wikipediaa, mutta kuitenkin se toimii samojen periaatteiden mukaan. Booktype on kaikille avoin kirjoitusympäristö, jossa on mahdollista kirjoittaa käyttöohjeita tai vaikkapa koulutusmateriaaleja.

Uusi käyttöopas tuotetaan kaikkein tehokkaimmin kirjapyrähdyksessä, jossa ohjelmasta kiinnostuneet ihmiset kokoontuvat kirjoittamaan käyttöopasta. Joukossa on parhaimmillaan ohjelman käyttäjiä, teknisiä kirjoittajia, alan asiantuntijoita ja ohjelman kehittämiseen osallistuneita ohjelmoijia. Kirjapyrähdys voi usein tuottaa uuden käyttöoppaan muutamassa päivässä.

Verkosto on saanut maineen laadukkaan dokumentaation tuottajana. Sitä tukevat avainprojektit, kuten One Laptop Per Child ja Archive.org. Kieliyhteisö laajenee nopeasti - käyttöoppaita käännetään nyt yli kahdellekymmenelle kielelle.

Dokumentaation tarve

Vapaiden ja avoimen ohjelmien maailmassa on paljon ohjelmoijia. Usein teknisistä kirjoittajista näyttää kuitenkin olevan pulaa. Yleisen vitsin mukaan uusi käyttäjä yrittää käyttää avoimen lähdekoodin ohjelmaa, mutta häntä neuvotaan lukemaan lähdekoodia. Näin tekninen kirjoittaja voi helpottaa ohjelman käyttöönottoprojektia huomattavasti tarjoamalla avointa dokumentaatiota wikimuodossa.

Tämän vuoksi tarvitsemme FLOSS Manualsia. Ihannetilanteessa dokumentaatio vastaa loppukäyttäjien taitotasoa. Loppukäyttäjä ei luultavasti ole kiinnostunut käytetyn ohjelmointikielen hienouksista tai vastaavista teknisistä seikoista. Loppukäyttäjä tahtoo käyttää ohjelmaa.

Niinpä dokumentaatiossa käytetyn kielen tulisi olla ymmärrettävää maallikoille. Sitä ei tulisi kirjoittaa ohjelmointigurujen teknisellä jargonilla, kaikki tulisi kirjoittaa henkilölle, joka ei ymmärrä tietojenkäsittelytiedettä - mutta tahtoo tuottaa jotain.

Tämä on FLOSS Manualsin idea. Tämän vuoksi tarvitsemme laadukasta dokumentaatiota avoimen lähdekoodin ohjelmille - rakentaaksemme sillan koodaajien, dokumentoijien ja käyttäjien välille.

Käyttäjien ja kirjoittajien yhteisön rakentaminen

Pelkkä käyttöoppaan suomentaminen ei riitä. Sitä täytyy jatkuvasti päivittää, laajentaa ja lokalisoida sopimaan paikallisiin olosuhteisiin. Tämän vuoksi jokainen FLOSS Manualsin lokalisaatio tarvitsee kirjoittajien ja lukijoiden yhteisöä.

Wikiin pohjautuva yhteistyö merkitsee sitä, että lukemattomien käyttäjien pienistä muokkauksista muodostuu valtava määrä sisältöä.

Eri lokalisointien yhteistyön tuloksena FLOSS Manualsin pitäisi luoda myös globaalia synergiaa, jossa ideat virtaavat yhdestä kieliyhteisöstä toiseen.

FLOSS Manuals pyrkii luomaan ratkaisun uuden käyttäjän ongelmaan: mistä löydän ymmärrettävät käyttöohjeet tälle avoimen lähdekoodin ohjelmalle?

LUE ja KIRJOITA

FLOSS Manualsissa on kaksi perusosaa: LUE ja KIRJOITA.

LUE-osassa voi lukea käyttöoppaiden julkaistuja versioita verkossa ja ladata ne ePub tai PDF-tiedostoina. Olemme laatineet LUE-osaan monta käyttöopasta vapaiden ohjelmistojen käytöstä. Ne on järjestetty ohjelmistokategorioihin.

Jokainen käyttöopas auttaa käyttäjää aloittamaan ohjelman käytön. Yleisesti ottaen käyttöoppaat kattavat seuraavat asiat:   

  1. Mitä ohjelma tekee?
  2. Mitä ohjelma ei tee?
  3. Johdanto ohjelman aihepiiriin 
  4. Kuinka ohjelma asennetaan
  5. Kuinka perusasetukset tehdään                              
  6. Käyttöliittymän perusesittely
  7. Ohjelman tärkeimpien piirteiden käyttö kuvattuna askel askeleelta etenevillä ohjeilla
  8. Mistä löydät lisää apua ohjelman käyttöön

KIRJOITA-osassa voit kirjoittaa käyttöohjeita. Kirjoitusalustana toimii Booki. Valitettavasti joudut rekisteröimään käyttäjätunnuksen, koska spämmibotit ovat internetissä ainaisena riesana. 

FLOSS Manualsissa kaikki materiaali on lisensoitu niin, että kuka tahansa voi käyttää sitä mihin tahansa tarkoitukseen. Niinpä kannattaa rekisteröityä omalla nimelläsi, koska voit saada työstäsi arvaamatonta kunniaa. Mutta tietysti voit kirjautua myös nimimerkillä, koska kukapa tuota netissä valvoisi.