Obsah:

Jak připravujete technickou dokumentaci?
Jak připravujete technickou dokumentaci?

Video: Jak připravujete technickou dokumentaci?

Video: Jak připravujete technickou dokumentaci?
Video: TK 10 2024, Listopad
Anonim

Psaní pro vaše publikum: 6 kroků k vytvoření technické dokumentace, která si zvykne

  1. Plánování. Než začnete, uvědomte si účel a rozsah projektu.
  2. Draftování. Začněte s přehledem na vysoké úrovni o všech tématech, která se mají probrat.
  3. Recenze.
  4. Revize.
  5. Editace.
  6. Publikování/udržování.

Jednoduše řečeno, co by měla obsahovat technická dokumentace?

Technický psaní zahrnuje širokou škálu dokumentů. Zahrnují pokyny, recenze, zprávy, informační bulletiny, prezentace, webové stránky, brožury, návrhy, dopisy, letáky, grafiku, poznámky, tiskové zprávy, příručky, specifikace, stylové průvodce, programy a tak dále.

Kromě toho, jak připravujete dokumentaci pro projekt? Nejlepší postupy pro dokumentaci vašeho projektu

  1. Zahrňte soubor README, který obsahuje.
  2. Povolit sledování problémů pro ostatní.
  3. Napište dokumentaci API.
  4. Zdokumentujte svůj kód.
  5. Použijte konvence kódování, jako je organizace souborů, komentáře, konvence pojmenování, programovací postupy atd.
  6. Uveďte informace pro přispěvatele.

Za druhé, co je vytvoření technické dokumentace?

Technická dokumentace odkazuje na jakýkoli dokument který vysvětluje použití, funkčnost, tvorbu nebo architekturu produktu. Berte to jako základní průvodce „jak na to“pro vaše uživatele, nové zaměstnance, administrátory a kohokoli dalšího, kdo potřebuje vědět, jak váš produkt funguje.

Jak mohu zlepšit své dokumentační dovednosti?

Zde je několik jednoduchých a rychlých tipů, které vám a vašemu týmu pomohou okamžitě zlepšit vaši dokumentaci

  1. Tip 1) Ukončete to pomocí pasivního hlasu.
  2. Tip 2) K zapojení čtenáře použijte jednoduché vizuální prvky.
  3. Tip 3) Používejte skvělé tituly a odrážky.
  4. Tip 4) Zkroťte své zkratky a hlášky.
  5. Tip 5) Použijte Reperformance Standard.

Doporučuje: