Sisukord:

Kuidas koostate tehnilist dokumentatsiooni?
Kuidas koostate tehnilist dokumentatsiooni?

Video: Kuidas koostate tehnilist dokumentatsiooni?

Video: Kuidas koostate tehnilist dokumentatsiooni?
Video: Kuidas võrrelda krõpsude rasvasust? 2024, November
Anonim

Publikule kirjutamine: 6 sammu harjunud tehnilise dokumentatsiooni loomiseks

  1. Planeerimine. Enne alustamist teadke projekti eesmärki ja ulatust.
  2. Kavandamine. Alustage kõigi käsitletavate teemade kõrgetasemelise ülevaatega.
  3. Ülevaatamine.
  4. Läbivaatamine.
  5. Redigeerimine.
  6. Kirjastamine/hooldamine.

Lihtsalt, mida peaks tehniline dokumentatsioon sisaldama?

Tehniline kirjutamine hõlmab laias valikus dokumente. Need sisaldavad juhiseid, ülevaateid, aruandeid, infolehti, esitlusi, veebilehti, brošüüre, ettepanekuid, kirju, flaiereid, graafikat, memosid, pressiteateid, käsiraamatuid, spetsifikatsioone, stiilijuhiseid, päevakavasid ja nii edasi.

Lisaks, kuidas koostate projekti dokumentatsiooni? Projekti dokumenteerimise parimad tavad

  1. Kaasake README-fail, mis sisaldab.
  2. Luba probleemijälgija teistele.
  3. Kirjutage API dokumentatsioon.
  4. Dokumenteerige oma kood.
  5. Rakendage kodeerimistavasid, nagu failikorraldus, kommentaarid, nimetamistavad, programmeerimistavad jne.
  6. Kaasake teave kaastöölistele.

Teiseks, mis on tehnilise dokumentatsiooni koostamine?

Tehniline dokumentatsioon viitab mis tahes dokument mis selgitab toote kasutamist, funktsionaalsust, loomist ja arhitektuuri. Mõelge sellele kui mutrite ja poltide juhendile, kuidas oma kasutajatele, uutele töötajatele, administraatoritele ja kõigile teistele, kes peavad teadma, kuidas teie toode töötab.

Kuidas ma saan oma dokumenteerimisoskusi parandada?

Siin on mõned lihtsad ja kiired näpunäited, mis aitavad teil ja teie meeskonnal dokumentatsiooni viivitamatult täiustada

  1. Näpunäide 1) Lõpetage see passiivse häälega.
  2. Nõuanne 2) Kasutage lugeja kaasamiseks lihtsaid visuaale.
  3. Vihje 3) Kasutage suurepäraseid pealkirju ja täppe.
  4. Näpunäide 4) Taltsutage oma akronüüme ja buzz-sõnu.
  5. Vihje 5) Kasutage taasesituse standardit.

Soovitan: