Innehållsförteckning:

Hur förbereder du teknisk dokumentation?
Hur förbereder du teknisk dokumentation?

Video: Hur förbereder du teknisk dokumentation?

Video: Hur förbereder du teknisk dokumentation?
Video: More than Coffee: как войти в IT и остаться в живых. Отвечаем на ваши вопросы. Java и не только. 2024, Maj
Anonim

Skriva för din målgrupp: 6 steg för att skapa teknisk dokumentation som blir använd

  1. Planera. Känn till syftet och omfattningen av projektet innan du börjar.
  2. Utformning. Börja med en översikt på hög nivå om alla ämnen som ska behandlas.
  3. Granskning.
  4. Revidering.
  5. Redigering.
  6. Publicering/Underhåll.

Helt enkelt så, vad ska ingå i teknisk dokumentation?

Teknisk skrivande omfattar ett brett utbud av dokument. De inkluderar instruktioner, recensioner, rapporter, nyhetsbrev, presentationer, webbsidor, broschyrer, förslag, brev, flygblad, grafik, PM, pressmeddelanden, handböcker, specifikationer, stilguider, agendor och så vidare.

Dessutom, hur förbereder du dokumentation för ett projekt? Bästa metoder för att dokumentera ditt projekt

  1. Inkludera en README-fil som innehåller.
  2. Tillåt problemspårare för andra.
  3. Skriv en API-dokumentation.
  4. Dokumentera din kod.
  5. Tillämpa kodningskonventioner, såsom filorganisation, kommentarer, namnkonventioner, programmeringsmetoder, etc.
  6. Inkludera information för bidragsgivare.

För det andra, vad är skapa teknisk dokumentation?

Teknisk dokumentation avser någon dokumentera som förklarar användningen, funktionaliteten, skapandet eller arkitekturen av en produkt. Se det som en "hur man"-guide för dina användare, nyanställda, administratörer och alla andra som behöver veta hur din produkt fungerar.

Hur kan jag förbättra min dokumentationsförmåga?

Så här är några enkla och snabba tips som hjälper dig och ditt team att förbättra din dokumentation omedelbart

  1. Tips 1) Avsluta med den passiva rösten.
  2. Tips 2) Använd enkla bilder för att engagera din läsare.
  3. Tips 3) Använd bra titlar och kulor.
  4. Tips 4) Tämja dina akronymer och buzz ord.
  5. Tips 5) Använd Reperformance Standard.

Rekommenderad: