rg i • I • I ■ 2 • « • J • • • 4 • • I - 7 - ■•••■•*• I - to - ■ -U* I -12 • 1*0- • • H • I -B • 1 • K
-OfJlK>UU fJISdllld.
Na jakość sposobu pisania wpływają następujące elementy:
-Stosowanie formy aktywnej oraz zwracanie się bezpośrednio do czytelnika. Wynika z tego. że zamiast zdań:
Na ekranie pojawi się dialog...
Aby otworzyć pik należy wybrać z menu... powinny się pojawić zdania:
Na ekranie zobaczysz dialog...
Jeżel chcesz otworzyć pik. wybierz z menu...
-Poprawność gramatyczna I ortograficzna. Wszelkie błędy w dokumentacji obniżają zaufanie użytkownika do całego systemu. Obecnie wiele edytorów tekstu posiada narzędzia sprawdzania poprawności językowej (głównie ortografii), które pozwalają wykryć wiele błędów.
- Krótkie zdania. Nie zaleca się stosowania w dokumentacji użytkowej długich, złożonych zdań, które są zdecydowanie mniej czytelne niż kilka krótkich zdań zawierających pojedyncze Jakty.