jQuery to biblioteka, którą albo się uwielbia, albo nienawidzi. Można ją wychwalać za prostotę pisanego kodu i umożliwienie programiście tworzenie w prosty sposób zaawansowanych rozwiązań. Z drugiej strony, jako najbardziej popularne rozwiązanie stosowane przez twórców stron internetowych zebrało bardzo ostrą krytykę wśród tych, którzy są zwolennikami pisania własnego, “czystego” kodu, pozbawionego wszelkich “ulepszaczy”. Niezależnie od tego, czy jQuery jest Waszym codziennym pomocnikiem, czy solą w oku programisty - zapraszam do przejrzenia kolejnej porcji linków pokazujących jej możliwości.

Od dłuższego czasu odkrywam możliwości środowiska programistycznego Eclipse [głównie przy użyciu modułów CDT i PDT]. Jestem naprawdę zadowolony z tego programu, poza tym cieszę się, że społeczność wolnego oprogramowania mogła “dorobić się” tak porządnego narzędzia, przez co “kupowanie” wszelkiego rodzaju “zamkniętych” rozwiązań w sklepach typu Rapidshare tudzież serwisach zorientowanych wokół P2P powoli przestaje mieć sens. ;] Jedynym minusem takiej “przesiadki” jest jednak to, że ponownie trzeba nauczyć się “gdzie co jest” - skróty klawiaturowe, położenie różnych ustawień, przycisków - jednym słowem poznać nowe narzędzie co najmniej tak, jak znało się poprzednie. I chociaż Eclipse jest generalnie bardzo intuicyjne i w niewielu przypadkach musimy się czegokolwiek domyślać lub szukać, to jednak czasem bez pomocy ani rusz. Tak też było z opisanym w niniejszym artykule oknem dokumentacji.

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.