Jak czytać dokumentacje (np. Node JS)

Question

Jak coś to moje pierwsze pytanie na forum więc Witam wszystkich czytających post.

Nie wiem w jaką kategorie ustawić ale ta co jest chyba jest ok bo to jest o nauce.

Chciałbym zapytać jak czytać dokumentację aby się nie pogubić. Ponieważ jak czytam dokumentację na przykład noda.js (chciałbym się go nauczyć) to mam mindfucka i zastanawiam się na czym to polega i jak to działa. I czy ktoś mógł by mi wytłumaczyć mniej więcej jak czytać w jakiej kolejności aby dobrze zrozumieć jakąś dokumentacje.

Z góry dziękuję za odpowiedź

Answer 1

Dokumentacje raczej należy czytać wtedy kiedy potrzebujesz skorzystać z jakiejś funkcjonalności danej technologii i chcesz dowiedzieć się szczegółów na jej temat, np. wiesz, że chcesz skorzystać z std::vector (c++) i doczytujesz jakie operacje możesz na nim wykonać, jak wyglądają. Czytanie dokumentacji od tak, by się nauczyć danej technologii mija się z celem, chyba, że takowa została napisana w ten sposób, że jest jednocześnie wprowadzeniem do technologii ale z reguły te dwie rzeczy się rozdziela.

Comments

A jak mógłbym w sumie nauczyć się danej technologii przykladowo tego Noda js (najlepiej nie poprzez film na YouTube tylko czytając jak książkę) ?

---

Myślę, że najlepiej poszukać jakiegoś dobrego poradnika, powiedzmy w postaci tutoriala na yt: 

https://www.youtube.com/watch?v=w-7RQ46RgxU&list=PL4cUxeGkcC9gcy9lrvMJ75z9maRw4byYp

Czasem może okazać się, że jakaś konkretna książka jest bardzo dobrym źródłem nauki.

Answer 2

Ja proponuję Ci inną drogę. Weź sobie jakaś książkę do node (na helionie jest ich parę) albo jakiś tutorial w necie i gdy spotkasz tam jakiś moduł, np. fs do obsługi plików i jakieś jego funkcje to po prostu wyszukaj je sobie później na docs i powoli ogarniaj. Sam zoaczysz, że z czasem zaczniesz traktować dokumentacje jako źródło nie nauki całego języka/środowiska ale własnie do szukania pojedynczych rzeczy. Warto też od początku się tego uczyć abyś zrozumiał jak docs są robione, bo to nie do końca to samo co opis w książce.

I do tego polecam szukanie wiedzy np. na wątkach SO czy issue GH, to są mega wielkie źródła cennej wiedzy i doświadczeń wielu ludzi.