Spisu treści:

Jak przygotowujesz dokumentację techniczną?
Jak przygotowujesz dokumentację techniczną?

Wideo: Jak przygotowujesz dokumentację techniczną?

Wideo: Jak przygotowujesz dokumentację techniczną?
Wideo: Jak czytać dokumentacje? Przeprogramowany vLog v.0.0.47 2024, Listopad
Anonim

Pisanie dla odbiorców: 6 kroków do stworzenia dokumentacji technicznej, która zostanie wykorzystana

  1. Planowanie. Przed rozpoczęciem poznaj cel i zakres projektu.
  2. Redakcja. Zacznij od ogólnego zarysu wszystkich tematów, które chcesz omówić.
  3. Przeglądanie.
  4. Rewizja.
  5. Redagowanie.
  6. Publikowanie/utrzymanie.

Po prostu, co powinno znaleźć się w dokumentacji technicznej?

Techniczny pisanie obejmuje szeroką gamę dokumentów. Obejmują one instrukcje, recenzje, raporty, biuletyny, prezentacje, strony internetowe, broszury, propozycje, listy, ulotki, grafiki, notatki, komunikaty prasowe, podręczniki, specyfikacje, przewodniki stylistyczne, kalendarze i tak dalej.

Dodatkowo, jak przygotowujesz dokumentację do projektu? Najlepsze praktyki dokumentowania projektu

  1. Dołącz plik README, który zawiera.
  2. Zezwól innym na śledzenie problemów.
  3. Napisz dokumentację API.
  4. Udokumentuj swój kod.
  5. Zastosuj konwencje kodowania, takie jak organizacja plików, komentarze, konwencje nazewnictwa, praktyki programistyczne itp.
  6. Dołącz informacje dla współtwórców.

Po drugie, na czym polega tworzenie dokumentacji technicznej?

Dokumentacja techniczna odnosi się do dowolnego dokument wyjaśnia zastosowanie, funkcjonalność, tworzenie lub architekturę produktu. Pomyśl o tym jako o poradniku „jak to zrobić” dla użytkowników, nowych pracowników, administratorów i wszystkich innych, którzy muszą wiedzieć, jak działa Twój produkt.

Jak mogę poprawić swoje umiejętności dokumentacyjne?

Oto kilka prostych i szybkich wskazówek, które pomogą Tobie i Twojemu zespołowi w natychmiastowym ulepszeniu dokumentacji

  1. Wskazówka 1) Zakończ z głosem pasywnym.
  2. Wskazówka 2) Użyj prostych wizualizacji, aby zaangażować czytelnika.
  3. Wskazówka 3) Używaj świetnych tytułów i wypunktowań.
  4. Wskazówka 4) Oswój swoje akronimy i słowa buzzów.
  5. Wskazówka 5) Użyj standardu powtórzenia.

Zalecana: