[rosedu-general] Documentaţie
Vlad Dogaru
ddvlad at anaconda.cs.pub.ro
Mon Jan 14 20:20:15 EET 2008
Salut,
asta e ce s-a discutat Duminică, 13 ianuarie, despre documentaţie. Sper
să fie totul în regulă, minus unele mici scăpări datorate scrisului de
mână al lui Răzvan (nu ştiu ce cauţi inginer, ar trebui să fii doctor :o) ).
Vrem să facem un depozit de documentaţie pe wiki; specificaţiile la care
ne-am gândit ar fi:
* limba română
* ton familial
* orientat pe câte un program, uşor de parcurs
* conţinut sumar -- cine citeşte documentaţia ar trebui să poată folosi
programul relativ repede; nu vor fi acoperite lucrurile de fineţe decât
în secţiuni bine delimitate.
* fiecare item de documentaţie are un responsabil. El menţine pagina
într-o formă digerabilă, dar sub nicio formă nu este unic contribuitor.
Propunerea mea ar fi ca maintainer-ul să fie trecut pe pagină, iar
sugestiile de la persoane ``din exterior'' să ajungă la el. Eventual la
începutul fiecărei pagini trecem un şablon cu responsabilul şi un link
către politica despre rolul şi atribuţiile acestuia.
* astea nu erau pe foaie, deci probabil am ratat / denaturat unele
lucruri. Corectaţi-mă la ce am greşit.
Responsabilii nu sunt bătuţi în cuie. Dacă vreţi ceva care nu a fost
atribuit sau dacă vreţi să renunţaţi, go ahead. Scopul nu este să facem
ceva ce nu ne place -- atunci lucrurile devin o povară. Unele persoane
care nu au fost prezente au fost propuse de noi -- sper să nu fie o
problemă.
Sper să fi nimerit care dintre Mihai şi Andrei sunt responsabili unde --
cineva nu i-a trecut cu tot numele :-P
Lista cu documentaţia şi cu responsabilii o să o pun pe wiki în scurt timp.
Spor la lucru,
Vlad
--
There is nothing more dangerous than an
idea when it is the only one you have.
More information about the rosedu-general
mailing list