Sisällysluettelo:

Mitä on lähdekoodidokumentaatio?
Mitä on lähdekoodidokumentaatio?

Video: Mitä on lähdekoodidokumentaatio?

Video: Mitä on lähdekoodidokumentaatio?
Video: #MimmitKoodaa webinaari: Mitä avoimesta lähdekoodista tulisi tietää? 2024, Saattaa
Anonim

Ohjelmisto dokumentointi on kirjoitettu teksti tai kuvitus, joka tulee tietokoneohjelmiston mukana tai on upotettu siihen lähdekoodi . The dokumentointi joko selittää, miten ohjelmisto toimii tai miten sitä käytetään, ja se voi tarkoittaa eri asioita eri rooleissa oleville ihmisille. Arkkitehtuuri/suunnittelu – Ohjelmiston yleiskatsaus.

Kun tämä pidetään mielessä, miten koodaat asiakirjat?

Parhaat käytännöt dokumentaation kirjoittamiseen:

  1. Sisällytä README-tiedosto, joka sisältää.
  2. Salli ongelmanseuranta muille.
  3. Kirjoita API-dokumentaatio.
  4. Dokumentoi koodisi.
  5. Käytä koodauskäytäntöjä, kuten tiedostojen järjestämistä, kommentteja, nimeämiskäytäntöjä, ohjelmointikäytäntöjä jne.
  6. Sisällytä tiedot osallistujille.

Voidaan myös kysyä, mikä on käyttäjädokumentaatio? Käyttäjän dokumentaatio viittaa dokumentointi loppukäyttäjille tarjottavalle tuotteelle tai palvelulle. The käyttäjän dokumentaatio on suunniteltu auttamaan loppukäyttäjiä käyttämään tuotetta tai palvelua. Tätä kutsutaan usein nimellä käyttäjä apua. The käyttäjän dokumentaatio on osa asiakkaalle toimitettua kokonaistuotetta.

Millaisia dokumentaatiotyyppejä tämä huomioon ottaen ovat?

Tyypit järjestelmästä dokumentointi sisältää vaatimukset asiakirja , lähdekoodi asiakirja , laatuvakuutus dokumentointi , ohjelmistoarkkitehtuuri dokumentointi , ratkaisuohjeet ja ohjeopas kokeneille käyttäjille. Tyypit käyttäjästä dokumentointi sisältää koulutusoppaat, käyttöoppaat, julkaisutiedot ja asennusoppaat.

Mitä ohjelmiston dokumentaatioon pitäisi sisällyttää?

Mitä asiakirjoihin sisällytetään

  1. selitys siitä, mitä ohjelmistosi tekee ja minkä ongelman se ratkaisee.
  2. esimerkki olosuhteista, joissa koodiasi normaalisti käytettäisiin.
  3. linkit koodiin ja bugien seurantaan.
  4. Usein kysytyt kysymykset ja tavat pyytää tukea.
  5. ohjeet ohjelmiston asentamiseen.

Suositeltava: