INHOUDSOPGAWE:

Wat is bronkode dokumentasie?
Wat is bronkode dokumentasie?

Video: Wat is bronkode dokumentasie?

Video: Wat is bronkode dokumentasie?
Video: Computer Basics 18: How Source Code works 2024, November
Anonim

Sagteware dokumentasie is geskrewe teks of illustrasie wat rekenaarsagteware vergesel of ingebed is in die bronkode . Die dokumentasie óf verduidelik hoe die sagteware werk óf hoe om dit te gebruik, en kan verskillende dinge vir mense in verskillende rolle beteken. Argitektuur/Ontwerp – Oorsig van sagteware.

As u dit in die oog hou, hoe kodeer u dokumente?

Beste praktyke vir die skryf van dokumentasie:

  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.

'n Mens kan ook vra, wat is 'n gebruikersdokumentasie? Gebruikersdokumentasie verwys na die dokumentasie vir 'n produk of diens wat aan die eindgebruikers verskaf word. Die gebruikersdokumentasie is ontwerp om eindgebruikers te help om die produk of diens te gebruik. Dit word dikwels na verwys as gebruiker hulp. Die gebruikersdokumentasie is deel van die algehele produk wat aan die kliënt gelewer word.

As u dit in ag neem, wat is die tipes dokumentasie?

Tipes van stelsel dokumentasie 'n vereistes insluit dokument , bronkode dokument , kwaliteitsversekering dokumentasie , sagteware-argitektuur dokumentasie , oplossinginstruksies en 'n hulpgids vir gevorderde gebruikers. Tipes van gebruiker dokumentasie sluit opleidingshandleidings, gebruikershandleidings, vrystellingsaantekeninge en installasiegidse in.

Wat moet by sagtewaredokumentasie ingesluit word?

Wat om in jou dokumentasie in te sluit

  1. 'n verduideliking van wat jou sagteware doen en watter probleem dit oplos.
  2. 'n voorbeeld wat die omstandighede illustreer waarin jou kode normaalweg gebruik sal word.
  3. skakels na die kode en foutspoorder.
  4. Gereelde vrae en maniere om vir ondersteuning te vra.
  5. instruksies oor hoe om jou sagteware te installeer.

Aanbeveel: