Talaan ng mga Nilalaman:

Ano ang dokumentasyon ng source code?
Ano ang dokumentasyon ng source code?

Video: Ano ang dokumentasyon ng source code?

Video: Ano ang dokumentasyon ng source code?
Video: Intro to Xcode 14 - Lesson 2 (2023 / Xcode 14 / SwiftUI) 2024, Mayo
Anonim

Software dokumentasyon ay nakasulat na teksto o ilustrasyon na kasama ng computer software o naka-embed sa source code . Ang dokumentasyon alinman ay nagpapaliwanag kung paano gumagana ang software o kung paano ito gamitin, at maaaring magkaiba ang kahulugan ng mga tao sa iba't ibang tungkulin. Arkitektura/Disenyo – Pangkalahatang-ideya ng software.

Habang nakikita ito, paano mo iko-code ang mga dokumento?

Pinakamahuhusay na kagawian para sa pagsulat ng dokumentasyon:

  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.

Maaari ring magtanong, ano ang dokumentasyon ng gumagamit? Dokumentasyon ng gumagamit tumutukoy sa dokumentasyon para sa isang produkto o serbisyong ibinibigay sa mga end user. Ang dokumentasyon ng gumagamit ay dinisenyo upang tulungan ang mga end user na gamitin ang produkto o serbisyo. Ito ay madalas na tinutukoy bilang gumagamit tulong. Ang dokumentasyon ng gumagamit ay isang bahagi ng pangkalahatang produkto na inihahatid sa customer.

Kung isasaalang-alang ito, ano ang mga uri ng dokumentasyon?

Mga uri ng sistema dokumentasyon isama ang isang kinakailangan dokumento , source code dokumento , katiyakan sa kalidad dokumentasyon , arkitektura ng software dokumentasyon , mga tagubilin sa solusyon at isang gabay sa tulong para sa mga advanced na user. Mga uri ng user dokumentasyon isama ang mga manwal sa pagsasanay, mga manwal ng gumagamit, mga tala sa paglabas at mga gabay sa pag-install.

Ano ang dapat isama sa dokumentasyon ng software?

Ano ang Isasama sa Iyong Dokumentasyon

  1. isang paliwanag kung ano ang ginagawa ng iyong software at kung anong problema ang nalulutas nito.
  2. isang halimbawa na naglalarawan ng mga pangyayari kung saan karaniwang gagamitin ang iyong code.
  3. mga link sa code at mga bug tracker.
  4. Mga FAQ at paraan para humingi ng suporta.
  5. mga tagubilin kung paano i-install ang iyong software.

Inirerekumendang: