Po przebiciu się przez kilka framework'ów i kilka języków mialem różna odczucia co do jakości dokumentacji tegoż framework'a/języka.
Osobiście za najlepsza doc z jaką maiłem przyjemność pracować to AngularJS.
Podajcie swoje typy best ever forever dokumentacji na jakie trafiliście.
Ja mogę podać najgorszą -> Lucene ;]
Nigdy z tym nie pracowałem, ale znalazłem w google pod hasłem "best documentation": https://stripe.com/docs/api
Fajnie zrobione :P
Ja mam mieszane uczucia co do dokumentacji .net.
Wnerwia mnie, że każdy detal jest na osobnej stronie, co w połączeniu z długimi czasami ładowania się strony jest strasznie irytujące.
Sposób nawigacji jest po prostu tragiczny.
Wole jak cała klasa jest opisana na jednej stronie, łatwiej coś wyszukać przez Ctrl-F.
Wnerwia mnie, że każdy detal jest na osobnej stronie, co w połączeniu z długimi czasami ładowania się strony jest strasznie irytujące.
A ja jestem fanboyem Microsoftu. Świetna, rozbudowana, bardzo dokładna dokumentacja. Nawet wolę wszystko na oddzielnych stronach, bo szybkiego neta mam, a przynajmniej porządek jest. I tu zaznaczę, że ich dokumentacja jest świetna nie tylko, jeśli chodzi o .NET - również VBA czy Visual Studio są udokumentowane, wszystko grzecznie w swoich drzewkach kategorii i z odnośnikami do innych wersji...
Docsy AngularJS sporo się poprawiły, kiedyś to była istna męka. Teraz nawet mniej używane rzeczy są jako tako opisane.
Najbardziej użyteczne dla mnie do tej pory było http://api.highcharts.com/highcharts z racji masy przykładów na jsfiddle (odchodzi mi konieczność odpalenia danej funkcjonalności własnoręcznie, żeby podejrzeć - super sprawa).
Jak korzystałem z django jeszcze w wersji 1.0 to docsy też były bardzo wygodne. Na tyle, że kupowanie książki do django nie miało sensu. I jeśli miałbym wybierać, to właśnie ta dokumentacja zrobiła na mnie największe wrażenie.
aurel napisał(a):
A ja jestem fanboyem Microsoftu.
Hmm, zawsze myślałem, że kobietą jesteś ;) Co te komputery robią z ludźmi :P Ale tak, nigdy nie narzekałem na dokumentację od microsoftu :) Zwłaszcza, że większość i tak intelisense załatwia :)
To może nie jest pod wzlędem treści najlepsza dokumentacja - chodzi mi o tę do bazy danych Oracle.
http://docs.oracle.com/database/121/index.htm
Chciałem tylko zwrócić uwagę na dość przyjemną rzecz: każdy dokument jest tam dostępny w formatach HTML, PDF, EPUB i MOBI.
Qt
Ja bardzo lubię dokumentację Rusta (http://doc.rust-lang.org/std/) ze względu na fajną szukajkę, oczywiście jest jeszcze sporo do poprawy, ale praca wre, więc da się zrobić.
http://reactivex.io/documentation/operators/repeat.html
Ze względu na to że libka jest "wielotechnologiczna" - sample są w podkategoriach ale idea funkcji jest za każdym razem przedstawiana za pomocą takich kozackich diagramów
obok springowej https://gradle.org/documentation/