Kazalo:

Kako pripravljate tehnično dokumentacijo?
Kako pripravljate tehnično dokumentacijo?

Video: Kako pripravljate tehnično dokumentacijo?

Video: Kako pripravljate tehnično dokumentacijo?
Video: Java Tech Talk: Telegram бот на java за 1 час 2024, Maj
Anonim

Pisanje za svoje občinstvo: 6 korakov za ustvarjanje tehnične dokumentacije, ki se uporablja

  1. Načrtovanje. Preden začnete, se seznanite z namenom in obsegom projekta.
  2. Priprava. Začnite z orisom na visoki ravni o vseh temah, ki jih je treba obravnavati.
  3. Pregledovanje.
  4. Revidiranje.
  5. Urejanje.
  6. Objavljanje/Vzdrževanje.

Enostavno tako, kaj bi moralo biti vključeno v tehnično dokumentacijo?

Tehnični pisanje vključuje široko paleto dokumentov. Vključujejo navodila, ocene, poročila, glasila, predstavitve, spletne strani, brošure, predloge, pisma, letake, grafike, beležke, sporočila za javnost, priročnike, specifikacije, slogovne vodnike, dnevne rede in tako naprej.

Poleg tega, kako pripravite dokumentacijo za projekt? Najboljše prakse za dokumentiranje vašega projekta

  1. Vključite datoteko README, ki vsebuje.
  2. Dovoli sledilnik težav za druge.
  3. Napišite dokumentacijo za API.
  4. Dokumentirajte svojo kodo.
  5. Uporabite konvencije kodiranja, kot so organizacija datotek, komentarji, konvencije o poimenovanju, programske prakse itd.
  6. Vključite informacije za sodelavce.

Drugič, kaj je izdelava tehnične dokumentacije?

Tehnična dokumentacija se nanaša na katero koli dokument ki pojasnjuje uporabo, funkcionalnost, ustvarjanje ali arhitekturo izdelka. Pomislite na to kot na vodnik »kako narediti« za vaše uporabnike, nove zaposlene, skrbnike in vse druge, ki morajo vedeti, kako vaš izdelek deluje.

Kako lahko izboljšam svoje dokumentacijske spretnosti?

Tukaj je torej nekaj preprostih in hitrih nasvetov, ki vam in vaši ekipi pomagajo takoj izboljšati dokumentacijo

  1. Nasvet 1) Zaprite ga s pasivnim glasom.
  2. Nasvet 2) Uporabite preproste vizualne elemente, da pritegnete svojega bralca.
  3. Nasvet 3) Uporabite odlične naslove in oznake.
  4. Nasvet 4) Ukrotite svoje kratice in buzz besede.
  5. Nasvet 5) Uporabite standard Reperformance Standard.

Priporočena: