[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