Wiele osób narzeka na dosyć uciążliwy błąd w skrypcie WordPressa uniemożliwiający wylogowanie się z poprzez kliknięcie odpowiedniego linka w niektórych miejscach strony, takich jak panel administracyjny i formularz dodawania komentarza. Na oficjalnej stronie systemu, tudzież znajdujących się tam forach są pewne informacje na temat problemu, użytkownicy próbują sobie pomóc, jednak skuteczność rozwiązań [mierzona na podstawie wypowiedzi i nastrojów samych zainteresowanych] bynajmniej nie jest stuprocentowa. Nie lubię kiedy jakakolwiek funkcjonalność nie działa, nawet jeśli z niej nie korzystam - postanowiłem więc, że zrobię mały rekonesans, sprawdzę co dolega Wordpressowi i dowiem się jak to naprawić.

Ze względu na to, że jestem w trakcie tworzenia biblioteki która ma zamiar w przyszłości ujrzeć światło dzienne i powiedzieć “hello, world” na ekranie [mam nadzieję] wielu programistów i użytkowników końcowych, pomyślałem o tym, żeby w końcu zająć się napisaniem stosownej dokumentacji do projektu. Przez długi czas w moim kodzie funkcjonowały przeróżne komentarze opisujące mniej lub bardziej dokładnie “co się w danym miejscu dzieje”, ale były to bardziej opisy dla mnie, jako twórcy rozumiejącego cel i działanie poszczególnych elementów, niż dla kogoś, kto miałby w przyszłości korzystać z tego produktu. Pomyślałem więc [w “międzyczasie” zmuszając się do odrzucenia standardowego podejścia w stylu “dlaczego miałbym korzystać z rozwiązań zewnętrznych, skoro sam mogę stworzyć generator dopasowany do moich wymagań?”], że należałoby znaleźć dobre narzędzie pozwalające na stworzenie dokumentacji na podstawie kodu źródłowego w łatwy i w miarę przyjazny sposób.