Reklame

Hvis du er en 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 programmerere kender ikke deres foretrukne sprog, der vælges udefra. 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 udviklerwebsted. 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.

Dash-nag

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).

instagram viewer

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

Dash-docsets

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, der allerede findes.

Problemet er, at nogle sprog bare ikke er godt dokumenteret - som den forenklede JavaScript-modgift CoffeeScript CoffeeScript er JavaScript uden hovedpineJeg har aldrig rigtig godt ø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 ... Læs mere . Deres dokumentation er mere af en "Er det ikke cool?" vejledningsvejledning, der viser eksempler på sproget i handling uden egentlig at forklare hvordan ting fungerer.

Dash-kaffe

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

Med det sagt fungerer nogle dokumentationssæt meget godt, ligesom dem for Ruby. Dette er det sprog, der driver Ruby On Rails-webapplikationsrammen 3 interaktive, sjove, gratis måder at begynde at lære Ruby-programmeringssprog påRuby er et udtryksfuldt scripting-sprog på meget højt niveau. 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 ... Læs mere , har fuldt søgbar dokumentation og passer fint inden for Dash-æstetik.

Dash-rb

Der er også snyderark, der kan downloades i Dash. Disse fokuserer ikke på sprogfunktioner, men snarere på de avancerede funktioner i Git, medarbejdernes yndlingstekstredaktør Sublime Text 2 Prøv sublim tekst 2 til dine behov for redigering af kodekoderSublime 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 ... Læs mere 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 blot 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 støtter 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)

Matthew Hughes er en softwareudvikler og forfatter fra Liverpool, England. Han findes sjældent uden en kop stærk sort kaffe i hånden og forguder absolut sin Macbook Pro og hans kamera. Du kan læse hans blog på http://www.matthewhughes.co.uk og følg ham på twitter på @matthewhughes.