SlideShare a Scribd company logo
1 of 22
Download to read offline
FLOSS Manuals
Laadukasta dokumentaatiota avoimen lähdekoodin
  ohjelmille




Avoimen lähdekoodin dokumentaatio
Tomi Toivio, open source coordinator, m-cult
Mitä FLOSS Manuals ei ole
●   FLOSS Manuals ei sisällä hammaslankojen
    käyttöohjeita
●   FLOSS = Free/Libre Open Source Software
●   FLOSS = Vapaat ja Avoimen Lähdekoodin
    Ohjelmat
Mikä on FLOSS Manuals?

●FLOSS Manuals on dokumentaatiowiki avoimen lähdekoodin
ohjelmille.
●FLOSS Manuals tarjoaa ilmaisia käyttöoppaita, jotka julkaistaan
GPL-lisenssin alaisuudessa.
●Alkuperäinen versio oli englanniksi, nyt olemassa on myös
lokalisaatiot suomeksi, persiaksi ja hollanniksi.
Dokumentaation tarve

●Ihannetilanteessa dokumentaation kirjoittajat käyttävät
loppukäyttäjien tietomäärään sopivaa kieltä.
● Kaikki käsitteet tulisi selittää henkilölle, joka ei ymmärrä
tietojenkäsittelytiedettä.
●FLOSS Manuals rakentaa siltaa ohjelmien ja mahdollisten käyttäjien
välille.
Käyttäjien ja kirjoittajien
    yhteisön rakentaminen
●Pelkkä käyttöoppaan kääntäminen ei riitä, sitä täytyy jatkuvasti
päivittää, laajentaa ja lokalisoida sopimaan paikalliseen kulttuuriin.
●Pidämme työpajoja koulujen, kansalaismediakeskusten ja
käyttäjäyhteisöjen kanssa.
●Tämän tavoitteena on tuoda uusia käyttäjiä ja kirjoittajia avoimen
lähdekoodin yhteisöön.
FLOSS Manualsin tausta
●   Adam Hyde tahtoi lähettää videokuvaa netissä
    avoimen lähdekoodin ohjelmilla
●   Kyllästyi tarjolla olemaan dokumentaatioon
●   FLOSS Manuals perustettiin Amsterdamissa
    vuonna 2006
●   Englanninkielisessä versiossa lähemmäs 2000
    kirjoittajaa
●   Uusia käyttöoppaita laaditaan kirjapyrähdyksillä
FLOSS Manualsin rakenne
●   Lue – käyttöoppaiden julkaistut versiot
●   Kirjoita – käyttöoppaiden kehitysversiot, vaatii
    rekisteröinnin
●   Remiksaa – käyttöoppaiden remiksaus,
    julkaiseminen AJAX-muodossa jne.
●   Tietoa – uutiset ja muuta
Avoimen dokumentaation tila

    “LUE LÄHDEKOODIA”
       “ET VAIN OSAA”
+++++ +++++             initialize counter (cell #0) to 10

[                use loop to set the next four cells to 70/100/30/10

    > +++++ ++            add 7 to cell #1

    > +++++ +++++              add 10 to cell #2

    > +++             add 3 to cell #3

    >+               add 1 to cell #4

    <<<< -             decrement counter (cell #0)

]

> ++ .             print 'H'

>+.               print 'e'
Avoimen dokumentaation tila
Ongelmia:
1. Suljettu alusta (esimerkiksi CVS)
2. Suljettu – formaatti (esimerkiksi docbook)
3. Suljettu – lisenssi (esimerkiksi tavallinen
  tekijänoikeus)
4. Suljettu - organisaatio (kustantamo käyttää
  avointa lisenssiä)
5. Ohjelman kehittäjät kirjoittaneet
  ulkomuististaan
Avoimen dokumentaation tila
6. Ei ylläpidetä (vanhentunut)
7. Rajoittunut yleisö (dokumentaation
  ymmärtäminen vaatii liikaa teknisiä taitoja)
8. Vaikea löytää
9. Maksaa (maksullinen dokumentaatio ilmaisille
  ohjelmille)
Vapaan dokumentaation tulevaisuus
1. Avoin alusta (wiki)
2. Avoin formaatti (xhtml)
3. Avoin lisenssi (GPL)
4. Avoin organisaatio (FLOSS Manuals)
5. Kirjoitettua ohjelmia käyttäessä
6. Yhteisön ylläpitämä
7. Laajempi yleisö
8. Helppo löytää
9. Ilmainen ja vapaa!
Vapaa dokumentaatio tarvitsee
1. Alusta
2. Yhteisö
3. Sisältö
4. Vapaan dokumentaation
sektori
Vapaan dokumentaation sektori
1. Tarvitsee sisäisen arvostuksen
2. Tarvitsee ulkoisen arvostuksen
3. Tarvitsee tulonlähteitä
4. Tarvitsee onnistuneita malleja
5. Tarvitsee joukon erilaisia taitoja
6. Täytyy olla hauskaa, sosiaalista ja
  merkityksellistä
FLOSS Manualsin ominaisuuksia
1. Helppo kirjoittaa (WYSIWYG)
2. Vetovalikko sisällysluettelon luomiseen
3. Julkaisu napinpainalluksella
4. Kirjan muotoilu CSS:n avulla
5. Käyttöoppaiden uudelleenmiksaus
6. Tekijänoikeudet tekijöille
7. Käännöstyökalut
8. Lokalisaatiotyökalut
9. Sivuille sulautettu kirjakauppa
10. Elävät käyttöoppaat (AJAX)
11. Kirjapyrähdyksen sosiaalinen malli
Kirjapyrähdys
1. Luodaan yhteisö käyttöoppaan ympärille
2. 5-6 kirjoittajaa samassa huoneessa
3. Ruoka, asunto ja matkat järjestetään
4. Käyttöoppaiden sisältösuunnitelma etukäteen
5. Sisällysluettelo rakennetaan ensimmäisenä
  päivänä
6. 4 päivää kirjoittamista
7. 1 päivä viimeistelyä ja oikolukemista
Medios-projekti
●   Medios-projekti on osallistuvan median
    menetelmien ja työkalujen kehittämishanke
●   Projektissa mukana Helsingin
    kaupunginteatteri, Metropolia ja m-cult
●   M-cult lokalisoi Suomen FLOSS Manualsin ja
    järjestää sen pohjalta avoimen lähdekoodin
    ohjelmien mediatyöpajoja
●   Muuta m-cultin toimintaa esimerkiksi M2HZ-
    kanava
Tapahtumia
●   Suomen FLOSS Manuals -lokalisaatio avattu
    syyskuussa 2009
●   22 käyttöopasta käännetty
●   Avoimen lähdekoodin audiovisuaalisten
    työkalujen koulutusta esimerkiksi kirjastojen
    kanssa
●   Käännöspyrähdyksiä esimerkiksi yliopistojen
    kanssa
●   Avoimen lähdekoodin ohjelmien kenttästudio
Kirjapyrähdysideoita
●   Opas avoimen lähdekoodin ja kulttuurin
    lisenssien käyttöön (GPL, Creative Commons)
●   Scribus-käyttöopas
●   Streaming-prosessiopas
●   Avoimen videon tuotanto-opas
●   Irssi-käyttöopas
●   Arduino-opas
●   Ruby-verkkoalustan käyttöopas
Assimiloimme...
●   Kääntäjiä
●   Käyttöoppaiden päivittäjiä uusiin
    ohjelmaversioihin
●   Terminologian asiantuntijoita
●   Graafikoita
●   Käyttöoppaiden kirjoittajia
●   Oikolukijoita
●   Kaikki
Booki
●   Nykyinen alusta perustuu Tinwikiin
●   Uusi Booki-alusta on demovaiheessa
●   Bookia tukee Archive.org
●   Booki ei ole rajoittunut käyttöohjeisiin
●   FLOSS Manuals on vain yksi Bookin
    kirjoittajaryhmistä
●   Bookiin voi perustaa esimerkiksi
    tieteiskirjallisuutta kirjoittavan ryhmän
Samankaltaisia projekteja
Vastaavia wikejä:
●   Linux.fi – Linuxin dokumentaatiowiki
●   Wikibooks – esimerkiksi laaja Ubuntu-opas
●   Ohjelmien lokalisointi:
●   Lokalisointi.org – tietoa ohjelmien lokalisoinnista
    suomeksi
Kiitos!

Tomi Toivio
tomi@flossmanuals.net

http://fi.flossmanuals.net

More Related Content

Viewers also liked

Gala Ecommerce Awards 2016
Gala Ecommerce Awards 2016Gala Ecommerce Awards 2016
Gala Ecommerce Awards 2016Club Ecommerce
 
consumer behaviour
consumer behaviourconsumer behaviour
consumer behaviourdaruneejim
 
Filmes
FilmesFilmes
Filmesronanf
 
Guión de video
Guión de videoGuión de video
Guión de videoAline GA
 
Верстка_Лекция2
Верстка_Лекция2Верстка_Лекция2
Верстка_Лекция2itc73
 
Install laravel on openshift
Install laravel on openshiftInstall laravel on openshift
Install laravel on openshiftSamy Saad
 
Стажировка-2013, разработчики, занятие 8. Html, CSS
Стажировка-2013, разработчики, занятие 8. Html, CSSСтажировка-2013, разработчики, занятие 8. Html, CSS
Стажировка-2013, разработчики, занятие 8. Html, CSS7bits
 
게임개발엔진 유니티(unity) 소개 2013 devkorea
게임개발엔진 유니티(unity) 소개 2013 devkorea게임개발엔진 유니티(unity) 소개 2013 devkorea
게임개발엔진 유니티(unity) 소개 2013 devkoreaDaniel Lynn
 
20141219_室蘭工業大学附属図書館Facebookへの3つの提案 Facebookで私たちの仕事の「よさ」を発掘しましょう
20141219_室蘭工業大学附属図書館Facebookへの3つの提案 Facebookで私たちの仕事の「よさ」を発掘しましょう20141219_室蘭工業大学附属図書館Facebookへの3つの提案 Facebookで私たちの仕事の「よさ」を発掘しましょう
20141219_室蘭工業大学附属図書館Facebookへの3つの提案 Facebookで私たちの仕事の「よさ」を発掘しましょうHiroyuki Chiba
 
Станисла Ким. "Корпоративное обучение как инструмент продвижения ИТ-продуктов...
Станисла Ким. "Корпоративное обучение как инструмент продвижения ИТ-продуктов...Станисла Ким. "Корпоративное обучение как инструмент продвижения ИТ-продуктов...
Станисла Ким. "Корпоративное обучение как инструмент продвижения ИТ-продуктов...uransoft
 
barista_repo_libelle_lekker
barista_repo_libelle_lekkerbarista_repo_libelle_lekker
barista_repo_libelle_lekkerCaroline Dhont
 
¿A que es facil?
¿A que es facil?¿A que es facil?
¿A que es facil?luzdelluvia
 

Viewers also liked (17)

Penumpukan serumen AKPER PEMKAB MUNA
Penumpukan serumen AKPER PEMKAB MUNAPenumpukan serumen AKPER PEMKAB MUNA
Penumpukan serumen AKPER PEMKAB MUNA
 
Gala Ecommerce Awards 2016
Gala Ecommerce Awards 2016Gala Ecommerce Awards 2016
Gala Ecommerce Awards 2016
 
Ibw czech republic leaflet 2014
Ibw czech republic leaflet 2014Ibw czech republic leaflet 2014
Ibw czech republic leaflet 2014
 
consumer behaviour
consumer behaviourconsumer behaviour
consumer behaviour
 
Test de lectura
Test de lecturaTest de lectura
Test de lectura
 
Filmes
FilmesFilmes
Filmes
 
Guión de video
Guión de videoGuión de video
Guión de video
 
ICHENDORF 2015 low
ICHENDORF 2015 lowICHENDORF 2015 low
ICHENDORF 2015 low
 
Верстка_Лекция2
Верстка_Лекция2Верстка_Лекция2
Верстка_Лекция2
 
IM Service providers 2011
IM Service providers 2011IM Service providers 2011
IM Service providers 2011
 
Install laravel on openshift
Install laravel on openshiftInstall laravel on openshift
Install laravel on openshift
 
Стажировка-2013, разработчики, занятие 8. Html, CSS
Стажировка-2013, разработчики, занятие 8. Html, CSSСтажировка-2013, разработчики, занятие 8. Html, CSS
Стажировка-2013, разработчики, занятие 8. Html, CSS
 
게임개발엔진 유니티(unity) 소개 2013 devkorea
게임개발엔진 유니티(unity) 소개 2013 devkorea게임개발엔진 유니티(unity) 소개 2013 devkorea
게임개발엔진 유니티(unity) 소개 2013 devkorea
 
20141219_室蘭工業大学附属図書館Facebookへの3つの提案 Facebookで私たちの仕事の「よさ」を発掘しましょう
20141219_室蘭工業大学附属図書館Facebookへの3つの提案 Facebookで私たちの仕事の「よさ」を発掘しましょう20141219_室蘭工業大学附属図書館Facebookへの3つの提案 Facebookで私たちの仕事の「よさ」を発掘しましょう
20141219_室蘭工業大学附属図書館Facebookへの3つの提案 Facebookで私たちの仕事の「よさ」を発掘しましょう
 
Станисла Ким. "Корпоративное обучение как инструмент продвижения ИТ-продуктов...
Станисла Ким. "Корпоративное обучение как инструмент продвижения ИТ-продуктов...Станисла Ким. "Корпоративное обучение как инструмент продвижения ИТ-продуктов...
Станисла Ким. "Корпоративное обучение как инструмент продвижения ИТ-продуктов...
 
barista_repo_libelle_lekker
barista_repo_libelle_lekkerbarista_repo_libelle_lekker
barista_repo_libelle_lekker
 
¿A que es facil?
¿A que es facil?¿A que es facil?
¿A que es facil?
 

Similar to FLOSS Manuals

Avoin lähdekoodi oikeusministeriössä
Avoin lähdekoodi oikeusministeriössäAvoin lähdekoodi oikeusministeriössä
Avoin lähdekoodi oikeusministeriössämarttikarjala
 
Avoimet innovaatiot tietoyhteiskunnan eteenpäin vievänä voimana
Avoimet innovaatiot tietoyhteiskunnan eteenpäin vievänä voimanaAvoimet innovaatiot tietoyhteiskunnan eteenpäin vievänä voimana
Avoimet innovaatiot tietoyhteiskunnan eteenpäin vievänä voimanaOtto Kekäläinen
 
LibreOffice-opas
LibreOffice-opasLibreOffice-opas
LibreOffice-opasTomi Toivio
 
Open mind 2010_workshop_elias_aarnio
Open mind 2010_workshop_elias_aarnioOpen mind 2010_workshop_elias_aarnio
Open mind 2010_workshop_elias_aarnioeliasaarnio
 
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassaAvointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassaOtto Kekäläinen
 
Seravo-salaatti: OpenDocument - miksi sitä pitäisi käyttää ja miten se liitty...
Seravo-salaatti: OpenDocument - miksi sitä pitäisi käyttää ja miten se liitty...Seravo-salaatti: OpenDocument - miksi sitä pitäisi käyttää ja miten se liitty...
Seravo-salaatti: OpenDocument - miksi sitä pitäisi käyttää ja miten se liitty...Otto Kekäläinen
 
Palvelujen ohjelmointi JavaScriptillä: Node.js ja TypeScript
Palvelujen ohjelmointi JavaScriptillä: Node.js ja TypeScriptPalvelujen ohjelmointi JavaScriptillä: Node.js ja TypeScript
Palvelujen ohjelmointi JavaScriptillä: Node.js ja TypeScriptSovelto
 
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassaAvointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassaOtto Kekäläinen
 
Web-pohjaisten projektinhallintaohjelmien vertailua
Web-pohjaisten projektinhallintaohjelmien vertailuaWeb-pohjaisten projektinhallintaohjelmien vertailua
Web-pohjaisten projektinhallintaohjelmien vertailuaHarto Pönkä
 
Parhaat VALO-projektikäytännöt (Meego Summit 2011)
Parhaat VALO-projektikäytännöt (Meego Summit 2011)Parhaat VALO-projektikäytännöt (Meego Summit 2011)
Parhaat VALO-projektikäytännöt (Meego Summit 2011)Otto Kekäläinen
 
Avointen ohjelmien päivä 2013 - Software Freedom Day 2013
Avointen ohjelmien päivä 2013 - Software Freedom Day 2013Avointen ohjelmien päivä 2013 - Software Freedom Day 2013
Avointen ohjelmien päivä 2013 - Software Freedom Day 2013Otto Kekäläinen
 
Yrittäjän ilmaisohjelmat
Yrittäjän ilmaisohjelmatYrittäjän ilmaisohjelmat
Yrittäjän ilmaisohjelmatTimo Kumpulainen
 
Kansainvälistä ohjelmistokehitystä - Case Plone Midsummersprint 2017
Kansainvälistä ohjelmistokehitystä - Case Plone Midsummersprint 2017Kansainvälistä ohjelmistokehitystä - Case Plone Midsummersprint 2017
Kansainvälistä ohjelmistokehitystä - Case Plone Midsummersprint 2017Rikupekka Oksanen
 

Similar to FLOSS Manuals (20)

FLOSS Manuals
FLOSS ManualsFLOSS Manuals
FLOSS Manuals
 
Avoin lähdekoodi oikeusministeriössä
Avoin lähdekoodi oikeusministeriössäAvoin lähdekoodi oikeusministeriössä
Avoin lähdekoodi oikeusministeriössä
 
OpenOffice
OpenOfficeOpenOffice
OpenOffice
 
Ubuntu tutuksi
Ubuntu tutuksiUbuntu tutuksi
Ubuntu tutuksi
 
Avoimet innovaatiot tietoyhteiskunnan eteenpäin vievänä voimana
Avoimet innovaatiot tietoyhteiskunnan eteenpäin vievänä voimanaAvoimet innovaatiot tietoyhteiskunnan eteenpäin vievänä voimana
Avoimet innovaatiot tietoyhteiskunnan eteenpäin vievänä voimana
 
LibreOffice-opas
LibreOffice-opasLibreOffice-opas
LibreOffice-opas
 
LibreOffice
LibreOfficeLibreOffice
LibreOffice
 
Open mind 2010_workshop_elias_aarnio
Open mind 2010_workshop_elias_aarnioOpen mind 2010_workshop_elias_aarnio
Open mind 2010_workshop_elias_aarnio
 
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassaAvointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
 
Seravo-salaatti: OpenDocument - miksi sitä pitäisi käyttää ja miten se liitty...
Seravo-salaatti: OpenDocument - miksi sitä pitäisi käyttää ja miten se liitty...Seravo-salaatti: OpenDocument - miksi sitä pitäisi käyttää ja miten se liitty...
Seravo-salaatti: OpenDocument - miksi sitä pitäisi käyttää ja miten se liitty...
 
Palvelujen ohjelmointi JavaScriptillä: Node.js ja TypeScript
Palvelujen ohjelmointi JavaScriptillä: Node.js ja TypeScriptPalvelujen ohjelmointi JavaScriptillä: Node.js ja TypeScript
Palvelujen ohjelmointi JavaScriptillä: Node.js ja TypeScript
 
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassaAvointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
Avointen ja ilmaisten ohjelmien hyödyntäminen järjestötoiminnassa
 
Web-pohjaisten projektinhallintaohjelmien vertailua
Web-pohjaisten projektinhallintaohjelmien vertailuaWeb-pohjaisten projektinhallintaohjelmien vertailua
Web-pohjaisten projektinhallintaohjelmien vertailua
 
Parhaat VALO-projektikäytännöt (Meego Summit 2011)
Parhaat VALO-projektikäytännöt (Meego Summit 2011)Parhaat VALO-projektikäytännöt (Meego Summit 2011)
Parhaat VALO-projektikäytännöt (Meego Summit 2011)
 
Scribus
ScribusScribus
Scribus
 
Johdatus drupaliin
Johdatus drupaliinJohdatus drupaliin
Johdatus drupaliin
 
Avointen ohjelmien päivä 2013 - Software Freedom Day 2013
Avointen ohjelmien päivä 2013 - Software Freedom Day 2013Avointen ohjelmien päivä 2013 - Software Freedom Day 2013
Avointen ohjelmien päivä 2013 - Software Freedom Day 2013
 
Mobie Zine -julkaisut
Mobie Zine  -julkaisutMobie Zine  -julkaisut
Mobie Zine -julkaisut
 
Yrittäjän ilmaisohjelmat
Yrittäjän ilmaisohjelmatYrittäjän ilmaisohjelmat
Yrittäjän ilmaisohjelmat
 
Kansainvälistä ohjelmistokehitystä - Case Plone Midsummersprint 2017
Kansainvälistä ohjelmistokehitystä - Case Plone Midsummersprint 2017Kansainvälistä ohjelmistokehitystä - Case Plone Midsummersprint 2017
Kansainvälistä ohjelmistokehitystä - Case Plone Midsummersprint 2017
 

More from Tomi Toivio (20)

WordPress
WordPressWordPress
WordPress
 
VALO oppilaitoksissa
VALO oppilaitoksissaVALO oppilaitoksissa
VALO oppilaitoksissa
 
Tekstitys
TekstitysTekstitys
Tekstitys
 
Processing
ProcessingProcessing
Processing
 
Stellarium
StellariumStellarium
Stellarium
 
StatusNet
StatusNetStatusNet
StatusNet
 
OpenStreetMap
OpenStreetMapOpenStreetMap
OpenStreetMap
 
OpenShot
OpenShotOpenShot
OpenShot
 
Ogg Theora
Ogg TheoraOgg Theora
Ogg Theora
 
Miro
MiroMiro
Miro
 
Muse
MuseMuse
Muse
 
Linphone
LinphoneLinphone
Linphone
 
Komentorivin perusteet
Komentorivin perusteetKomentorivin perusteet
Komentorivin perusteet
 
Kirjapyrähdys
KirjapyrähdysKirjapyrähdys
Kirjapyrähdys
 
Kino
KinoKino
Kino
 
Jubler
JublerJubler
Jubler
 
Tietoturvan perusteet
Tietoturvan perusteetTietoturvan perusteet
Tietoturvan perusteet
 
Gtranscode
GtranscodeGtranscode
Gtranscode
 
Internet Archive
Internet ArchiveInternet Archive
Internet Archive
 
Inkscape
InkscapeInkscape
Inkscape
 

FLOSS Manuals

  • 1. FLOSS Manuals Laadukasta dokumentaatiota avoimen lähdekoodin ohjelmille Avoimen lähdekoodin dokumentaatio Tomi Toivio, open source coordinator, m-cult
  • 2. Mitä FLOSS Manuals ei ole ● FLOSS Manuals ei sisällä hammaslankojen käyttöohjeita ● FLOSS = Free/Libre Open Source Software ● FLOSS = Vapaat ja Avoimen Lähdekoodin Ohjelmat
  • 3. Mikä on FLOSS Manuals? ●FLOSS Manuals on dokumentaatiowiki avoimen lähdekoodin ohjelmille. ●FLOSS Manuals tarjoaa ilmaisia käyttöoppaita, jotka julkaistaan GPL-lisenssin alaisuudessa. ●Alkuperäinen versio oli englanniksi, nyt olemassa on myös lokalisaatiot suomeksi, persiaksi ja hollanniksi.
  • 4. Dokumentaation tarve ●Ihannetilanteessa dokumentaation kirjoittajat käyttävät loppukäyttäjien tietomäärään sopivaa kieltä. ● Kaikki käsitteet tulisi selittää henkilölle, joka ei ymmärrä tietojenkäsittelytiedettä. ●FLOSS Manuals rakentaa siltaa ohjelmien ja mahdollisten käyttäjien välille.
  • 5. Käyttäjien ja kirjoittajien yhteisön rakentaminen ●Pelkkä käyttöoppaan kääntäminen ei riitä, sitä täytyy jatkuvasti päivittää, laajentaa ja lokalisoida sopimaan paikalliseen kulttuuriin. ●Pidämme työpajoja koulujen, kansalaismediakeskusten ja käyttäjäyhteisöjen kanssa. ●Tämän tavoitteena on tuoda uusia käyttäjiä ja kirjoittajia avoimen lähdekoodin yhteisöön.
  • 6. FLOSS Manualsin tausta ● Adam Hyde tahtoi lähettää videokuvaa netissä avoimen lähdekoodin ohjelmilla ● Kyllästyi tarjolla olemaan dokumentaatioon ● FLOSS Manuals perustettiin Amsterdamissa vuonna 2006 ● Englanninkielisessä versiossa lähemmäs 2000 kirjoittajaa ● Uusia käyttöoppaita laaditaan kirjapyrähdyksillä
  • 7. FLOSS Manualsin rakenne ● Lue – käyttöoppaiden julkaistut versiot ● Kirjoita – käyttöoppaiden kehitysversiot, vaatii rekisteröinnin ● Remiksaa – käyttöoppaiden remiksaus, julkaiseminen AJAX-muodossa jne. ● Tietoa – uutiset ja muuta
  • 8. Avoimen dokumentaation tila “LUE LÄHDEKOODIA” “ET VAIN OSAA” +++++ +++++ initialize counter (cell #0) to 10 [ use loop to set the next four cells to 70/100/30/10 > +++++ ++ add 7 to cell #1 > +++++ +++++ add 10 to cell #2 > +++ add 3 to cell #3 >+ add 1 to cell #4 <<<< - decrement counter (cell #0) ] > ++ . print 'H' >+. print 'e'
  • 9. Avoimen dokumentaation tila Ongelmia: 1. Suljettu alusta (esimerkiksi CVS) 2. Suljettu – formaatti (esimerkiksi docbook) 3. Suljettu – lisenssi (esimerkiksi tavallinen tekijänoikeus) 4. Suljettu - organisaatio (kustantamo käyttää avointa lisenssiä) 5. Ohjelman kehittäjät kirjoittaneet ulkomuististaan
  • 10. Avoimen dokumentaation tila 6. Ei ylläpidetä (vanhentunut) 7. Rajoittunut yleisö (dokumentaation ymmärtäminen vaatii liikaa teknisiä taitoja) 8. Vaikea löytää 9. Maksaa (maksullinen dokumentaatio ilmaisille ohjelmille)
  • 11. Vapaan dokumentaation tulevaisuus 1. Avoin alusta (wiki) 2. Avoin formaatti (xhtml) 3. Avoin lisenssi (GPL) 4. Avoin organisaatio (FLOSS Manuals) 5. Kirjoitettua ohjelmia käyttäessä 6. Yhteisön ylläpitämä 7. Laajempi yleisö 8. Helppo löytää 9. Ilmainen ja vapaa!
  • 12. Vapaa dokumentaatio tarvitsee 1. Alusta 2. Yhteisö 3. Sisältö 4. Vapaan dokumentaation sektori
  • 13. Vapaan dokumentaation sektori 1. Tarvitsee sisäisen arvostuksen 2. Tarvitsee ulkoisen arvostuksen 3. Tarvitsee tulonlähteitä 4. Tarvitsee onnistuneita malleja 5. Tarvitsee joukon erilaisia taitoja 6. Täytyy olla hauskaa, sosiaalista ja merkityksellistä
  • 14. FLOSS Manualsin ominaisuuksia 1. Helppo kirjoittaa (WYSIWYG) 2. Vetovalikko sisällysluettelon luomiseen 3. Julkaisu napinpainalluksella 4. Kirjan muotoilu CSS:n avulla 5. Käyttöoppaiden uudelleenmiksaus 6. Tekijänoikeudet tekijöille 7. Käännöstyökalut 8. Lokalisaatiotyökalut 9. Sivuille sulautettu kirjakauppa 10. Elävät käyttöoppaat (AJAX) 11. Kirjapyrähdyksen sosiaalinen malli
  • 15. Kirjapyrähdys 1. Luodaan yhteisö käyttöoppaan ympärille 2. 5-6 kirjoittajaa samassa huoneessa 3. Ruoka, asunto ja matkat järjestetään 4. Käyttöoppaiden sisältösuunnitelma etukäteen 5. Sisällysluettelo rakennetaan ensimmäisenä päivänä 6. 4 päivää kirjoittamista 7. 1 päivä viimeistelyä ja oikolukemista
  • 16. Medios-projekti ● Medios-projekti on osallistuvan median menetelmien ja työkalujen kehittämishanke ● Projektissa mukana Helsingin kaupunginteatteri, Metropolia ja m-cult ● M-cult lokalisoi Suomen FLOSS Manualsin ja järjestää sen pohjalta avoimen lähdekoodin ohjelmien mediatyöpajoja ● Muuta m-cultin toimintaa esimerkiksi M2HZ- kanava
  • 17. Tapahtumia ● Suomen FLOSS Manuals -lokalisaatio avattu syyskuussa 2009 ● 22 käyttöopasta käännetty ● Avoimen lähdekoodin audiovisuaalisten työkalujen koulutusta esimerkiksi kirjastojen kanssa ● Käännöspyrähdyksiä esimerkiksi yliopistojen kanssa ● Avoimen lähdekoodin ohjelmien kenttästudio
  • 18. Kirjapyrähdysideoita ● Opas avoimen lähdekoodin ja kulttuurin lisenssien käyttöön (GPL, Creative Commons) ● Scribus-käyttöopas ● Streaming-prosessiopas ● Avoimen videon tuotanto-opas ● Irssi-käyttöopas ● Arduino-opas ● Ruby-verkkoalustan käyttöopas
  • 19. Assimiloimme... ● Kääntäjiä ● Käyttöoppaiden päivittäjiä uusiin ohjelmaversioihin ● Terminologian asiantuntijoita ● Graafikoita ● Käyttöoppaiden kirjoittajia ● Oikolukijoita ● Kaikki
  • 20. Booki ● Nykyinen alusta perustuu Tinwikiin ● Uusi Booki-alusta on demovaiheessa ● Bookia tukee Archive.org ● Booki ei ole rajoittunut käyttöohjeisiin ● FLOSS Manuals on vain yksi Bookin kirjoittajaryhmistä ● Bookiin voi perustaa esimerkiksi tieteiskirjallisuutta kirjoittavan ryhmän
  • 21. Samankaltaisia projekteja Vastaavia wikejä: ● Linux.fi – Linuxin dokumentaatiowiki ● Wikibooks – esimerkiksi laaja Ubuntu-opas ● Ohjelmien lokalisointi: ● Lokalisointi.org – tietoa ohjelmien lokalisoinnista suomeksi