EaiiŁii y ■-.y........ŁY-r...... i iŁ jjii i t ~
- Powtarzanie trudnego opisu. Szczególnie ważne informacje, których opis może być trudny dla czytelnika można powtarzać w różnych miejscach dokumentacji.
- Stosowanie tytułów I podtytułów sekcji, wyliczeń I wyróżnień. Wymienione elementy ożywiają tekst i pozwalają zwrócić uwagę czytelnika na najistotniejsze informacje.
-Zrozumiale odwołania do Innych rozdziałów. Odwołując się do rozdziału należy podać nie tylko jego numer, lecz także krótki opis zawartości. Odwołanie nie powinno więc wyglądać w następujący sposób:
W rozdziale 5.1 znajduje się... lecz następująco:
W rozdziale 5.1. omawiającym zagadnienia... znajduje się...
Komentarza wymaga podane jako pierwsze zalecenie zwracania się bezpośrednio do czytelnika. Jest to zasada stworzona z myślą o języku angielskim, który ma zupełnie inne tradycje niż język polski. Stosowanie tej
MJL
Al
wrs 8 KOL 1