Dash bringer kodningsdokumentation til Mac-skrivebordet

Hvis du er programmør, er du allerede meget afhængig af dokumentation. Dash (gratis, $ 19.99 for fuld version) er en Mac-app designet til at gøre din krævede læsning til en mere behagelig oplevelse.

De fleste programmører kender ikke deres foretrukne sprog, der vælges inde og ude. Endnu færre kan prale af en detaljeret viden om hvert bibliotek og API, de kommer i kontakt med. Som programmerere Google vi. Vi spørger Stack Overflow. Vi læser dokumentation. Masser og masser af dokumentation. De fleste læser dokumentation i en browser, men der er en bedre måde. Mød Dash.

Dash og dokumentation

Dash er en app, der lokalt gemmer dokumentation fra Internettet og giver dig adgang til den via en bestemt webapplikation. Det kan downloades fra udviklerwebstedet. Forskellen mellem gratis og betalt er minimal, den gratis version leveres med en ventetid ved opstart, og hver gang du skifter mellem dokumentationssæt (docsets) og vil narre dig til at købe det.

Hvis du vælger at opgradere til den betalte version af Dash, kan du i det mindste bruge den på så mange Mac-computere, som du ejer (et ubegrænset antal ifølge udviklerne).

Dash's værdiproposition er baseret på antallet af biblioteker og sprog, det understøtter, og det er her det skinner.

Næsten alle sprog, API og bibliotek, du kan tænke på, er repræsenteret, såvel som nogle, du sandsynligvis ikke har hørt om. Både web, mobil og system er godt repræsenteret her.

Personligt udvikler jeg mig til nettet i både en front og back-end kapacitet, og alt hvad jeg bruger er til stede her. Desværre er kvaliteten af ​​dokumentationen lidt af en blandet taske.

Kvaliteten af ​​dokumentationen

Udviklerne oprettede ikke selve dokumentationen, så det er ikke rigtig deres skyld. Som jeg sagde før, lagrer Dash kun cache i forudgående dokumentation.

Problemet er, at nogle sprog bare ikke er godt dokumenteret - som den forenklede JavaScript-modgift. CoffeeScript CoffeeScript er JavaScript uden hovedpine. CoffeeScript er JavaScript uden hovedpine. Jeg har aldrig virkelig ønsket at skrive JavaScript så meget. Fra den dag, jeg skrev min første linje ved hjælp af den, har jeg altid vred mig over, at uanset hvad jeg skriver i det altid ender med at se ud som en Jackson…. Deres dokumentation er mere en “Er det ikke cool?” vejledning i hvordan man viser eksempler på sproget i handling uden egentlig at forklare hvordan ting fungerer.

I tilfælde af CoffeeScript ser det desuden ikke godt ud i Dash. Det er meget bedre egnet til en webbrowser.

Når det er sagt, fungerer nogle dokumentationssæt meget godt, ligesom dem for Ruby. Dette er det sprog, der driver Ruby On Rails-webapplikationsrammerne 3 Interaktive, sjove, gratis måder at begynde at lære Ruby-programmeringssprog 3 Interaktive, sjove, gratis måder at begynde at lære Ruby-programmeringssprog Ruby er et udtryksfuldt, meget højt niveau , scriptingsprog. Det bruges hovedsageligt på Internettet som en del af webudviklingsrammen Ruby on Rails, men også som enkeltstående. Hvis du er nysgerrig efter, hvad Ruby (ikke ...) har fuldt søgbar dokumentation og passer fint inden for Dash-æstetikken.

Der er også snyderark, der kan downloades i Dash. Disse fokuserer ikke på sprogfunktioner, men snarere på de avancerede funktioner i Git, personalets foretrukne tekstredigerer Sublime Text 2 Prøv Sublime Text 2 til din tværplatformkode Redigeringsbehov Prøv Sublime Text 2 til din Cross-Platform Code Editing Needs Sublime Text 2 er en kodeditor på tværs af platforme, som jeg kun for nylig har hørt om, og jeg må sige, at jeg er virkelig imponeret trods beta-mærket. Du kan downloade den fulde app uden at betale en krone ... og 3 og andre populære softwarepakker.

Snyderark er også tilgængelige til HTTP-funktioner, HTML- og CSS-navngivne farver.

Tilgængelighed

Jeg kender en masse udviklere, der kæmper for at læse sort tekst på hvid baggrund. Nogle bruger endda specielt tonede briller for at gøre det lettere for dem at læse. Nogle har simpelthen brug for at forstørre tekst.

Jeg har ikke fundet nogen specifikke tilgængelighedsindstillinger i Dash, og jeg har heller ikke fundet nogen måde at øge størrelsen på tekst på. Det kan være et afbrydere for nogle synshæmmede brugere. OS X leveres dog med nogle tilgængelighedsfunktioner (Systemindstillinger> System> Tilgængelighed) hvilket muligvis gør Dash den smule mere anvendelig.

Konklusion

Skal du få den betalte version af Dash? Det kommer an på. Der er ikke rigtig nogen overbevisende funktioner, der gør opgraderingen værd at udgiften, men du vil støtte projektet ved at chippe ind.

Jeg bruger den gratis version af Dash på næsten daglig basis. Hvis du slynger kode til levevis og ejer en Mac, har du brug for denne app. Det er ikke perfekt, men det får jobbet gjort.

Hent: Dash til Mac OS X (gratis, $ 19.99 for fuld version)

Hvad synes du? Download det og lad os vide dine tanker i kommentarerne nedenfor.

Fotokredit: kode (Michael Himbeault)