[rosedu-general] Documentaţie

[Alex Eftimie]

2008/1/14 Vlad Dogaru <ddvlad at anaconda.cs.pub.ro>:
> 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.

Pagina wiki pentru documentatie este:
http://dev.rosedu.org/trac/rosedu/wiki/Documentatie (pentru toate
DNS-urile, altfel http://wiki.rosedu.org/Documentatie ).

Alex

-- 
Alex Eftimie
http://anaconda.cs.pub.ro/~alexef/