Obsah:

Ako pripravujete technickú dokumentáciu?
Ako pripravujete technickú dokumentáciu?

Video: Ako pripravujete technickú dokumentáciu?

Video: Ako pripravujete technickú dokumentáciu?
Video: Robert Fico o zrušení generálnej prokuratúry 2024, Smieť
Anonim

Písanie pre vaše publikum: 6 krokov na vytvorenie technickej dokumentácie, ktorá sa dá použiť

  1. Plánovanie. Skôr ako začnete, zistite účel a rozsah projektu.
  2. Drafting. Začnite s prehľadom na vysokej úrovni o všetkých témach, ktoré sa majú prebrať.
  3. Recenzia.
  4. Revízia.
  5. Úprava.
  6. Publikovanie/udržiavanie.

Jednoducho, čo by mala obsahovať technická dokumentácia?

Technická písanie zahŕňa širokú škálu dokumentov. Zahŕňajú pokyny, recenzie, správy, bulletiny, prezentácie, webové stránky, brožúry, návrhy, listy, letáky, grafiku, poznámky, tlačové správy, príručky, špecifikácie, štýlové príručky, programy atď.

Okrem toho, ako pripravujete dokumentáciu pre projekt? Najlepšie postupy na zdokumentovanie vášho projektu

  1. Zahrňte súbor README, ktorý obsahuje.
  2. Povoliť sledovanie problémov pre ostatných.
  3. Napíšte dokumentáciu API.
  4. Zdokumentujte svoj kód.
  5. Aplikujte konvencie kódovania, ako je organizácia súborov, komentáre, konvencie pomenovania, programovacie postupy atď.
  6. Zahrňte informácie pre prispievateľov.

Po druhé, čo je vytvorenie technickej dokumentácie?

Technická dokumentácia odkazuje na akékoľvek dokument ktorý vysvetľuje použitie, funkčnosť, tvorbu alebo architektúru produktu. Berte to ako základnú príručku „ako na to“pre vašich používateľov, nových zamestnancov, správcov a kohokoľvek iného, kto potrebuje vedieť, ako váš produkt funguje.

Ako môžem zlepšiť svoje dokumentačné zručnosti?

Tu je niekoľko jednoduchých a rýchlych tipov, ktoré vám a vášmu tímu pomôžu okamžite zlepšiť vašu dokumentáciu

  1. Tip 1) Ukončite to s pasívnym hlasom.
  2. Tip 2) Na zapojenie čitateľa použite jednoduché vizuálne prvky.
  3. Tip 3) Používajte skvelé názvy a odrážky.
  4. Tip 4) Skrotte svoje skratky a hlášky.
  5. Tip 5) Použite Reperformance Standard.

Odporúča: