Crearea documentației de programare este o etapă importantă, deoarece utilizatorul își începe cunoștința cu produsul software cu documentația. Pentru ce este produsul software? cum să instalați un produs software, cum să începeți să lucrați cu acesta - acestea sunt unele dintre primele întrebări la care ar trebui să răspundă documentația software (Ghid de instalare, Noțiuni de bază). Compilarea documentelor de programare este de obicei gestionată de oameni speciali - scriitori (uneori programatorii se scriu programatori sau analiști). Această etapă este cea mai neplăcută și mai dificilă în activitatea de programare. Din păcate, de obicei, acest lucru nu este învățat deloc sau, în cel mai bun caz, nu acordă atenție calității documentelor primite. Cu toate acestea, posesia acestei arte este unul dintre cei mai importanti factori care determina calitatea programatorului.
Pachetul de documentație software corect compilat (mai exact, creat) vă va salva de la multe probleme. În special, puteți scăpa de întrebări enervante și revendicări nerezonabile prin trimiterea pur și simplu către utilizator la documentație. Aceasta se referă în primul rând la cel mai important document - Termenii de Referință. Puteți să vă amintiți un proces în mai multe milioane de zile împotriva IBM, care a fost prezentat de un editor important, nu este mulțumit de calitatea computerelor și a software-ului. Tribunalul IBM a câștigat numai datorită faptului că a prezentat Termenii de referință semnat de ambele părți. A fost cu mult timp în urmă, în anii 70 ai secolului XX, dar esența problemei nu o schimbă. În Occident, importanța documentației software a fost înțeleasă de mult timp, împreună cu software-ul, este livrat un întreg pachet de documente.
Când un programator-dezvoltator primește într-o formă sau alta o sarcină de programare, în fața lui, managerul de proiect și întreaga echipă de proiect se confruntă cu următoarele întrebări:
• Ce trebuie făcut în afară de programul propriu-zis?
• Ce și cum ar trebui să fie documentate?
• Ce ar trebui să transmită utilizatorilor și care este serviciul de escortă?
• Cum să gestionăm întregul proces?
• Ce ar trebui să fie inclus în sarcina de programare în sine?
Aceste și alte întrebări au fost odată preluate de standardele statului pentru documentația software - un set de standarde ale GOST ESDP din seria 19. Dar chiar și atunci, programatorii au avut multe pretenții față de aceste standarde. Ceva trebuia să fie duplicat în documentație de multe ori (așa cum sa dovedit - nejustificat), dar multe nu au fost furnizate, cum ar fi reflectarea specificului documentării programelor care funcționează cu baza de date integrată.
Au trecut mulți ani, programarea se desfășoară într-un mediu de tehnologii complet noi, mulți programatori, care lucrează în stilul drag-and-drop, nu mai pot vedea textele programelor lor ani de zile. Aceasta nu înseamnă că nevoia de a le documenta a dispărut. Întrebările legate de disponibilitatea cel puțin a unui sistem care reglementează această parte a dezvoltării software, continuă să fie întrebate în mod constant.
Articole similare
-
Controlul dezvoltării activității și standardizării software-ului și a tehnologiilor informaționale
-
Site personal - 33 de standardizare în domeniul software-ului
-
Gosty și standardele industriei pentru dezvoltarea de software - articole - dezvoltare și
Trimiteți-le prietenilor: