INHOUDSOPGAWE:

Hoe berei jy tegniese dokumentasie voor?
Hoe berei jy tegniese dokumentasie voor?

Video: Hoe berei jy tegniese dokumentasie voor?

Video: Hoe berei jy tegniese dokumentasie voor?
Video: Ремонт на балконе Ошибки монтажа теплого пола. #37 2024, April
Anonim

Skryf vir jou gehoor: 6 stappe vir die skep van tegniese dokumentasie wat gebruik word

  1. Beplanning. Ken die doel en omvang van die projek voordat jy begin.
  2. Opstel. Begin met 'n hoë-vlak uiteensetting oor alle onderwerpe om te ontdek.
  3. Hersiening.
  4. Hersiening.
  5. Redigering.
  6. Publisering/Instandhouding.

Eenvoudig so, wat moet by tegniese dokumentasie ingesluit word?

Tegnies skryfwerk sluit 'n wye reeks dokumente in. Dit sluit instruksies, resensies, verslae, nuusbriewe, aanbiedings, webblaaie, brosjures, voorstelle, briewe, strooibiljette, grafika, memo's, persvrystellings, handboeke, spesifikasies, stylgidse, agendas ensovoorts in.

Daarbenewens, hoe berei jy dokumentasie vir 'n projek voor? Beste praktyke om jou projek te dokumenteer

  1. Sluit 'n README-lêer in wat bevat.
  2. Laat kwessiespoorder vir ander toe.
  3. Skryf 'n API-dokumentasie.
  4. Dokumenteer jou kode.
  5. Pas koderingskonvensies toe, soos lêerorganisasie, opmerkings, naamkonvensies, programmeringspraktyke, ens.
  6. Sluit inligting vir bydraers in.

Tweedens, wat is die skep van tegniese dokumentasie?

Tegniese dokumentasie verwys na enige dokument wat die gebruik, funksionaliteit, skepping of argitektuur van 'n produk verduidelik. Dink daaraan as 'n moer-en-boute "hoe om"-gids vir jou gebruikers, nuwe werknemers, administrateurs en enigiemand anders wat moet weet hoe jou produk werk.

Hoe kan ek my dokumentasievaardighede verbeter?

So, hier is 'n paar eenvoudige en vinnige wenke om jou en jou span te help om jou dokumentasie onmiddellik te verbeter

  1. Wenk 1) Verlaat dit met die Passiewe Stem.
  2. Wenk 2) Gebruik eenvoudige beeldmateriaal om jou leser te betrek.
  3. Wenk 3) Gebruik goeie titels en kolpunte.
  4. Wenk 4) Maak jou akronieme en gonswoorde teem.
  5. Wenk 5) Gebruik die Herprestasiestandaard.

Aanbeveel: