Talaan ng mga Nilalaman:

Paano ka naghahanda ng teknikal na dokumentasyon?
Paano ka naghahanda ng teknikal na dokumentasyon?

Video: Paano ka naghahanda ng teknikal na dokumentasyon?

Video: Paano ka naghahanda ng teknikal na dokumentasyon?
Video: РЕПОРТАЖ - пресс-ланч с участием отцов-основателей группы «Земляне» 28 января 2022 2024, Mayo
Anonim

Pagsusulat para sa Iyong Audience: 6 na Hakbang para sa Paggawa ng Teknikal na Dokumentasyon na Nagagamit

  1. Pagpaplano. Alamin ang layunin at saklaw ng proyekto bago ka magsimula.
  2. Pag-draft. Magsimula sa isang mataas na antas na balangkas sa lahat ng paksang tatalakayin.
  3. Nagsusuri.
  4. Pagrerebisa.
  5. Pag-edit.
  6. Paglalathala / Pagpapanatili.

Kaya lang, ano ang dapat isama sa teknikal na dokumentasyon?

Teknikal Kasama sa pagsulat ang isang malawak na hanay ng mga dokumento. Kasama sa mga ito ang mga tagubilin, pagsusuri, ulat, newsletter, presentasyon, web page, brochure, panukala, liham, flier, graphics, memo, press release, handbook, detalye, gabay sa istilo, agenda at iba pa.

Bukod pa rito, paano ka naghahanda ng dokumentasyon para sa isang proyekto? Pinakamahuhusay na Kasanayan para sa Pagdodokumento ng Iyong Proyekto

  1. Isama ang README file na naglalaman ng.
  2. Payagan ang tagasubaybay ng isyu para sa iba.
  3. Sumulat ng dokumentasyon ng API.
  4. Idokumento ang iyong code.
  5. Mag-apply ng mga coding convention, gaya ng file organization, komento, pagbibigay ng pangalan, programming practices, atbp.
  6. Isama ang impormasyon para sa mga kontribyutor.

Pangalawa, ano ang paglikha ng teknikal na dokumentasyon?

Teknikal na dokumentasyon tumutukoy sa alinman dokumento na nagpapaliwanag sa paggamit, functionality, paglikha, orarchitecture ng isang produkto. Isipin ito bilang isang nuts-and-bolts “how to” guide para sa iyong mga user, bagong hire, administrator, at sinumang kailangang malaman kung paano gumagana ang iyong produkto.

Paano ko mapapabuti ang aking mga kasanayan sa dokumentasyon?

Kaya, narito ang ilang simple at mabilis na tip upang matulungan ka at ang iyong koponan na mapahusay kaagad ang iyong dokumentasyon

  1. Tip 1) Ihinto ito gamit ang Passive Voice.
  2. Tip 2) Gumamit ng Mga Simpleng Visual para Himukin ang iyong Reader.
  3. Tip 3) Gumamit ng Mahusay na Mga Pamagat at Bala.
  4. Tip 4) Amuin ang iyong mga Acronym at Buzz Words.
  5. Tip 5) Gamitin ang Reperformance Standard.

Inirerekumendang: