Reklama

Jeśli jesteś programistą, już w dużej mierze polegasz na dokumentacji. Dziarskość (darmowa, 19,99 USD za pełną wersję) to aplikacja na komputery Mac, która sprawia, że ​​czytanie staje się przyjemniejsze.

Większość programistów nie zna swojego preferowanego języka od podszewki. Jeszcze mniej posiada szczegółową wiedzę o każdej bibliotece i interfejsie API, z którymi się stykają. Jako programiści my Google. Prosimy o przepełnienie stosu. Czytamy dokumentację. Dużo dokumentacji. Większość ludzi czyta dokumentację w przeglądarce, ale jest lepszy sposób. Poznaj Dash.

Dash and Documentation

Dash to aplikacja, która lokalnie buforuje dokumentację z Internetu i umożliwia dostęp do niej za pośrednictwem określonej aplikacji internetowej. Można go pobrać z witryna programisty. Różnica między darmowym a płatnym jest minimalna, darmowa wersja ma czas oczekiwania na uruchomienie i za każdym razem, gdy przełączasz się między zestawami dokumentacji (docset) i nakłania cię do zakupu.

dash-nag

Jeśli zdecydujesz się na uaktualnienie do płatnej wersji Dash, możesz przynajmniej użyć go na tylu komputerach Mac, ile posiadasz (nieograniczona liczba, według programistów).

instagram viewer

Propozycja wartości Dasha oparta jest na liczbie obsługiwanych bibliotek i języków, i właśnie tutaj świeci.

dash-docsets

Przedstawione są prawie wszystkie języki, interfejsy API i biblioteki, o których myślisz, a także niektóre, o których prawdopodobnie nie słyszałeś. Sieć, telefon komórkowy i system są tutaj dobrze reprezentowane.

Osobiście rozwijam się w Internecie zarówno z przodu, jak i z tyłu, i wszystko, czego używam, jest tutaj. Niestety jakość dokumentacji jest trochę mieszana.

Jakość dokumentacji

Programiści nie stworzyli dokumentacji samodzielnie, więc to nie jest tak naprawdę ich wina. Jak powiedziałem wcześniej, Dash buforuje tylko wcześniej istniejącą dokumentację.

Problem polega na tym, że niektóre języki nie są dobrze udokumentowane - jak uproszczone antidotum na JavaScript CoffeeScript CoffeeScript to JavaScript bez problemówNigdy tak bardzo nie lubiłem pisać JavaScript. Od dnia, w którym napisałem w nim moją pierwszą linię, zawsze żałowałem, że cokolwiek w niej piszę, zawsze wygląda jak Jackson ... Czytaj więcej . Ich dokumentacja jest raczej „Czy to nie jest fajne?” poradnik, pokazujący przykłady języka w akcji, bez faktycznego wyjaśnienia w jaki sposób rzeczy działają.

dash-coffee

Ponadto w przypadku CoffeeScript nie wygląda dobrze w Dash. Jest znacznie lepiej dostosowany do przeglądarki internetowej.

To powiedziawszy, niektóre zestawy dokumentacji działają bardzo dobrze, jak te dla Ruby. To jest język, który napędza platformę internetową aplikacji Ruby On Rails 3 Interaktywne, zabawne, bezpłatne sposoby na rozpoczęcie nauki języka programowania RubyRuby to ekspresyjny język skryptowy na wysokim poziomie. Jest używany w sieci głównie jako część środowiska programistycznego Ruby on Rails, ale także jako samodzielny program. Jeśli jesteś ciekawy, co Ruby (nie ... Czytaj więcej , ma w pełni przeszukiwalną dokumentację i ładnie pasuje do estetyki Dash.

dash-rb

Istnieją również ściągawki dostępne do pobrania w Dash. Nie koncentrują się one na funkcjach językowych, ale na zaawansowanych funkcjach Git, ulubiony edytor tekstu pracowników Sublime Text 2 Wypróbuj Sublime Text 2 dla swoich potrzeb w zakresie edytowania kodu na wielu platformachSublime Text 2 to wieloplatformowy edytor kodów, o którym dopiero niedawno słyszałem i muszę powiedzieć, że jestem pod wrażeniem pomimo etykiety beta. Możesz pobrać pełną aplikację bez płacenia ani grosza ... Czytaj więcej oraz 3 i inne popularne pakiety oprogramowania.

Ściągawki są również dostępne dla funkcji HTTP, HTML i nazwanych kolorów CSS.

Dostępność

Znam wielu programistów, którzy mają trudności z czytaniem czarnego tekstu na białym tle. Niektórzy noszą nawet przyciemniane okulary, aby ułatwić im czytanie. Niektórzy po prostu muszą powiększyć tekst.

Nie znalazłem żadnych konkretnych ustawień dostępności w Dash, ani nie znalazłem żadnego sposobu na zwiększenie rozmiaru tekstu. Może to stanowić przełom dla niektórych użytkowników niedowidzących. Jednak system OS X jest wyposażony w niektóre funkcje ułatwień dostępu (Preferencje systemowe> System> Dostępność), co może sprawić, że Dash będzie bardziej użyteczny.

Wniosek

Czy powinieneś dostać płatną wersję Dash? To zależy. Naprawdę nie ma żadnych atrakcyjnych funkcji, które sprawiłyby, że aktualizacja była tego warta, ale będziesz wspierać projekt, włączając się.

Korzystam z darmowej wersji Dash prawie codziennie. Jeśli używasz procy dla posiadacza Maca, potrzebujesz tej aplikacji. Nie jest idealny, ale wykonuje zadanie.

Pobieranie:Dash dla Mac OS X. (za darmo, 19,99 USD za pełną wersję)

Co myślisz? Pobierz go i daj nam znać, co myślisz w komentarzach poniżej.

Kredyt zdjęciowy: Kod (Michael Himbeault)

Matthew Hughes jest programistą i pisarzem z Liverpoolu w Anglii. Rzadko można go znaleźć bez filiżanki mocnej czarnej kawy w dłoni i absolutnie uwielbia swojego Macbooka Pro i aparat. Możesz przeczytać jego blog na http://www.matthewhughes.co.uk i śledź go na Twitterze na @matthewhughes.