Nasze oprogramowanie było używane przez wielu użytkowników, a dział szkoleń poprosił nas o wszelkie wskazówki dotyczące formatu dokumentacji użytkownika końcowego.
Czy ktoś wie, gdzie mogę znaleźć dobre przykłady dokumentacji użytkownika końcowego oprogramowania, z której dział szkolenia może skorzystać w celu uzyskania inspiracji, lub witryny z dobrą poradą?
Jest to podobne do tego pytania, jednak szukam dokumentacji użytkownika końcowego do użytku przez użytkowników nietechnicznych.
Odpowiedzi:
Możesz zacząć od wywiadów z użytkownikami wewnętrznymi na temat oprogramowania i dowiedzieć się, jakie informacje chcieliby wiedzieć.
Duża część dokumentacji, którą napisałem o oprogramowaniu, miała na myśli jedną lub wielu odbiorców. Twój dział szkoleniowy prawdopodobnie skorzystałby ze szkieletu tematów (jak spis treści). Następnie możesz omówić, które tematy są istotne, a które nie mają znaczenia dla ich celów szkoleniowych.
Niektóre tematy mogą obejmować:
Staraj się przewidywać, w jaki sposób użytkownicy końcowi korzystają z twojego oprogramowania, w oparciu o twoją wiedzę na temat jego tworzenia, twoją wiedzę na temat jego działania, a także na podstawie (miejmy nadzieję) wywiadów z użytkownikami końcowymi.
Co najważniejsze, spróbuj stworzyć dokumentację, którą chcesz przeczytać, użyj zabawnych przykładowych nazw, aby zademonstrować, i używaj wielu zrzutów ekranu z adnotacjami.
Mam nadzieję że to pomoże
źródło
Przeczytałem kilka „Przewodników użytkownika końcowego” i napisałem jeden, i uważam, że istnieje wiele elementów, które poprawiają ich skuteczność:
Mam nadzieję, że może ci się to przydać.
źródło
Wspominasz, że zostanie wykorzystany do treningu.
Jeśli szukasz dokumentu szkoleniowego zamiast dokumentu referencyjnego, moją ulubioną taką witryną jest tutorial Joela Spolsky'ego na temat Mercurial tutaj .
Jeśli twój dokument treningowy był 1/2 tak fajny jak samouczek Mercura Joela, przeczytałbym go. Ale potrzebujesz kogoś z a) pasją do pisania oraz b) niewiarygodną głębią wiedzy, aby ją zdobyć, nawet jeśli możesz skopiować 3 punkty powyżej. Mam nadzieję, że to działa.
źródło
Nie wiem, czy to pasuje do twoich potrzeb, ale istnieją systemy używane do dokumentacji technicznej, które sfinks przychodzą na myśl, które ułatwiają tworzenie dokumentacji online. Czy coś takiego można wykorzystać do tego, co Cię interesuje?
Właśnie natknąłem się na ReadTheDocs, który robi to samo, ale jest hostowanym rozwiązaniem.
źródło
Sprawdź Society for Technical Communication (STC) . Wielu zdobywców nagród napisało produkcję, która jest ogólnie dostępna. Mogą również mieć dostępne próbki. Zostanie członkiem zapewni również dostęp do większej ilości informacji.
źródło