[selinux-aktiva] IRC-träff: dokumentation

[Alexander Nordström]

Hej på er alla!

Sedan augusti har jag tagit över ansvaret för dokumentationsgruppen[1], 
och det är hög tid att få den här bollen i rullning. Jag vet att vi har 
många kunniga medlemmar som skulle kunna bidra med bra dokumentation.

[1] http://se.linux.org/arbetsgrupper/dokumentation

Deltagande i gruppen är öppet för alla och är inte ett större åtagande 
än man gör det till. Arbetet är gemensamt, så det går bra att hjälpa 
till även om man känner sig osäker eller tycker att ens kunskaper är 
ofullständiga.

För att få igång lite diskussion, hitta spännande idéer och starta 
initiativ tänkte vi därför ha en liten sammankomst i #dokumentation på 
irc.se.linux.org[2] nu på måndag den 29 november klockan 19:00. Alla 
intresserade är välkomna.

[2] http://se.linux.org/kommunikation/chat/

Jag hoppas att vi ska kunna föra en öppen och informell diskussion, och 
det finns ingen egentlig dagordning, men jag nämner några frågor här 
nedanför som kan vara värda att fundera på och diskutera. Har du något 
annat som du vill ta upp? Vill du framföra något trots att tiden kanske 
inte passar? Andra frågor eller funderingar? Skriv gärna och berätta!

Frågor att ta upp:

Vilka projekt bör vi ägna oss åt? Ska vi skriva en eller flera 
sammanhängande webbaserade, bokliknande dokumentationssamlingar, eller 
är fristående dokumentation för enskilda program bättre?

Hur ska arbetet koordineras? Ska vem som helst kunna lägga in och 
publicera dokument, eller ska dokumenten skickas in för granskning? Hur 
kan vi bäst motivera och peppa deltagare och inspirera till nya 
initiativ?

Ska man kunna kommentera andras dokument? Kommentarer blir snabbt
inaktuella om författaren fixar det som klagas på. Man skulle kanske 
kunna göra det möjligt att kommentera ett dokument privat. Ska det 
finnas ett betygssystem?

Hur ska dokumenten sorteras och struktureras? Kan specifika dokument bli 
lättare att hitta än de är idag?

Gnu FDL[3], Gnuprojektets licens för fri dokumentation, har fått viss 
kritik[4] och anses inte vara fri enligt DFSG[5], Debianprojektets 
riktlinjer för fri programvara. Avvikelserna anses tillräckligt 
lindriga för att inte hindra att nästa Debianversion släpps med 
DFSG-licensierad dokumentation, men den mer långsiktiga målsättningen 
är att eliminera användning av licensen i Debian. Hur bör vi i Svenska 
Linuxföreningen ställa oss till licensen för existerande, nyskriven och 
inhämtad dokumentation?

[3] http://se.linux.org/dokumentation/licenser/fdl-sv/fdl-sv.html
[4] http://people.debian.org/~branden/fdl/
[5] http://www.debian.org/social_contract.sv.html#guidelines

Avslutningsvis vill jag passa på att tacka Tim Terlegård som bidragit 
med många av idéerna som ligger till grund för det här meddelandet. Tim 
har också skissat på ett förslag till innehållsförteckning[6] till en 
sådan bok som nämns här ovan.

[6] http://se.linux.org/Medlemmar/tim/bok

Väl mött på måndag klockan 19:00!

-- 
Alexander Nordström
Styrelseledamot och dokumentationsansvarig
Svenska Linuxföreningen
http://se.linux.org
-------------- next part --------------
En bilaga som inte var text, skiljdes ut...
Namn       : inte tillgänglig
Typ       : application/pgp-signature
Storlek: 189 bytes
Beskrivning: inte tillgänglig
URL        : http://mail.se.linux.org/pipermail/selinux-aktiva/attachments/20041128/4d1ed948/attachment.pgp