documentație pentru software, documentație pentru utilizator, documentație - compania

Documentația pentru software-ul - l documentele care însoțesc produsul software (SW) - un produs program sau software. Aceste documente descriu modul în care funcționează programul și / sau cum să-l folosească.

Documentația este o parte importantă de dezvoltare de software, dar este adesea neglijată.

Există patru tipuri de bază de documentație pentru software-ul:

• Arhitectura / Design - prezentare generală a software-ului, inclusiv mediul de operare, precum și o descriere a principiilor care ar trebui să fie utilizate la crearea unui software
• tehnic - documentație de cod, algoritmi, interfețe, API
• de utilizare - ghid pentru utilizatorii finali, administratorii de sistem și de alți membri ai personalului
• marketing

Arhitectura documentare / proiectare

Documentația de proiect descrie, de obicei, produsul în general. Fără a descrie modul în care este folosit ceva, probabil răspunde la întrebarea „De ce?“ De exemplu, în documentul de proiect programator poate descrie rațiunea de ce aceste structuri sunt organizate în acest mod. Descrie motivele pentru care orice clasă este proiectat într-un anumit fel, stand modele, în unele cazuri, chiar și având în vedere ideea de modul în care va fi posibil să se realizeze îmbunătățiri în viitor. Nimic din toate acestea sunt incluse în documentația tehnică sau de utilizator, dar este foarte important pentru proiect.

documentația tehnică

Aceasta este exact ceea ce se înțelege prin documentația pe termen lung a majorității programatorilor. La crearea unui program, cod în sine nu este de obicei suficient. Ar trebui să se acorde un text care descrie diferitele aspecte ale ceea ce face codul. Această documentație este adesea inclusă direct în codul sursă sau furnizat împreună cu acesta.

Această documentație este foarte pronunțat caracter tehnic și este utilizat în principal pentru a detecta și Descrierea API, structuri de date și algoritmi.

documentație pentru utilizator

Spre deosebire de documentația tehnică, axat pe codul și modul în care funcționează, doar documentația pentru utilizator descrie modul de utilizare a programului.

În cazul în care produsul este o bibliotecă de software, documentație pentru utilizator și documentația pentru codul sunt foarte aproape, aproape echivalent. Dar, în general, nu este.

De obicei, documentația pentru utilizator este un manual care descrie fiecare funcție a programului, precum și măsuri pe care le puteți urma pentru a utiliza această funcție. documentație de utilizare bună merge un pas mai departe și oferă instrucțiuni despre ce să facă în caz de probleme. Este important ca documentația să nu inducă în eroare și a fost relevantă. Managementul ar trebui să aibă o structură clară; foarte util în cazul în care există un indice de subiect transversal. coerență logică și simplitatea sunt de asemenea importante.

Există trei abordări privind organizarea documentației de utilizator. Ghidul pentru începători (Eng. Tutorial), cel mai util pentru utilizatori noi, se urmărește în mod constant pentru o serie de măsuri care sunt utilizate pentru a îndeplini orice sarcini tipice. Abordarea tematică, în care fiecare capitol al manualului este dedicat un subiect special, mai potrivite pentru îmbunătățirea utilizatorului. În acest din urmă, a treia abordare, echipa sau sarcina sunt organizate în directorul alfabetic - de multe ori bine acceptate de către utilizatorii avansați care sunt familiarizați cu ceea ce caută. Reclamațiile utilizatorilor sunt, de obicei legate de faptul că documentația acoperă doar una dintre aceste abordări, și este, prin urmare, foarte potrivit pentru doar o singură clasă de utilizatori.

În multe cazuri, dezvoltatorii de software limitată set de documentație de utilizare este built-in numai sistemul de ajutor (ing. Ajutor online), care conține informații de referință cu privire la comenzile sau elementele de meniu. Lucrările la formarea noilor utilizatori și susținerea îmbunătățirii utilizatorul este transmis editorilor privați, oferind adesea asistență semnificativă pentru dezvoltatori.

documentație de marketing

1. ascuți interes în produsul de către potențialii utilizatori
2. i informeze despre ceea ce face ca produsul, astfel încât să se potrivească așteptărilor lor, astfel încât acestea vor primi
3. pentru a explica poziția produsului în raport cu soluțiile concurente

Unul bune practici de marketing - asigurarea unui slogan - o expresie ușor de reținut simplu, ilustrând ceea ce dorim să transmitem către utilizator, precum și caracterizarea sentimentul. care creează un produs.

Se întâmplă adesea ca cutia produsului și alte materiale de marketing dau o imagine mai clară a posibilităților și modalitățile de utilizare a programului decât orice altceva.