šablóna

Dokumentácia a používateľské príručky, Manuály pre technickú podporu

Univerzálna šablóna support položky (ready-to-use pre prax)

Séria: Ako písať dokumentáciu a manuály v IT projekte

 

Reálny problém z praxe

Support dokumentácia existuje.

Každý ju píše po svojom:

  • niekto opisuje funkcionalitu
  • niekto píše voľný text
  • niekto dá len pár bodov

Výsledok:

  • nedá sa v tom vyhľadávať
  • nedá sa to použiť konzistentne
  • každá odpoveď vyzerá inak

A hlavne:

rovnaké problémy sa riešia rôznymi spôsobmi.…

Administrátorská príručka, Dokumentácia a používateľské príručky

Univerzálna šablóna administrátorskej príručky (core + custom vrstvy)

Séria: Ako písať dokumentáciu a manuály v IT projekte

 

Reálny problém z praxe

Administrátorská príručka vznikala postupne.

Najprv core funkcionalita.
Potom klientská úprava.
Potom ďalší klient.

Po čase:

  • konfigurácia je popísaná na viacerých miestach
  • nie je jasné, čo je štandard a čo výnimka
  • admin nevie, čo platí pre jeho prostredie

Typická otázka:

Platí toto pre všetkých, alebo len pre konkrétneho klienta?…

Dokumentácia a používateľské príručky, Používateľské manuály

Univerzálna šablóna používateľského manuálu (core + custom vrstva)

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Tím napíše manuál.

Pri prvej zmene funkcionality ho upraví.
Pri druhom klientovi ho rozšíri.
Pri treťom klientovi doplní výnimky.

Po čase:

  • rovnaká funkcionalita je opísaná na troch miestach
  • text si protirečí
  • nikto nevie, čo je vlastne štandard

A keď príde nový kolega:

„Platí toto pre všetkých?“…

Ako testovať..., Notifikácie a komunikácia so zákazníkom, Všeobecné témy

Ako testovať e-mailovú šablónu s dynamickými údajmi z databázy

Príklad šablóny:

Predmet: Objednávka č. {{order_id}} bola úspešne prijatá

Dobrý deň, {{customer_name}},
ďakujeme za Vašu objednávku. Tu sú jej podrobnosti:

• Produkt: {{product_name}}
• Množstvo: {{quantity}}
• Cena spolu: {{total_price}} €

Vaša objednávka bude odoslaná na adresu:
{{delivery_address}}

S pozdravom,
Tím {{company_name}}


Čo všetko otestovať:

1.

Návrat hore