Dash bringer koding av dokumentasjon til Mac-skrivebordet

Annonse

Hvis du er en programmerer, er du allerede veldig stolt på dokumentasjon. Bindestrek (gratis, $ 19.99 for fullversjon) er en Mac-app designet for å gjøre den påkrevde lesningen til en mer behagelig opplevelse.

De fleste programmerere kjenner ikke sitt foretrukne språk utenfra. Enda færre kan skryte av detaljert kunnskap om hvert bibliotek og API de kommer i kontakt med. Som programmerere Google vi. Vi spør Stack Overflow. Vi leser dokumentasjon. Mye og mye dokumentasjon. De fleste leser dokumentasjon i nettleseren, men det er en bedre måte. Møt Dash.

Dash og dokumentasjon

Dash er en app som lokalt lagrer dokumentasjon fra Internett og lar deg få tilgang til den gjennom en spesifikk nettapplikasjon. Det kan lastes ned fra utvikler nettsted. Forskjellen mellom gratis og betalt er minimal, gratisversjonen har en ventetid ved oppstart, og hver gang du bytter mellom dokumentasjonssett (dokumentsett) og vil narre deg til å kjøpe det.

Hvis du velger å oppgradere til den betalte versjonen av Dash, kan du i det minste bruke den på så mange Mac-datamaskiner som du eier (et ubegrenset antall, ifølge utviklere).

Dashs verdiforslag er basert på antall biblioteker og språk den støtter, og det er her den skinner.

Stort sett alle språk, API og bibliotek du kan tenke på er representert, så vel som noen du sannsynligvis ikke har hørt om. Både web, mobil og system er godt representert her.

Personlig utvikler jeg for nettet både i front og back-end kapasitet, og alt jeg bruker er til stede her. Dessverre er kvaliteten på dokumentasjonen litt av en blandet pose.

Kvaliteten på dokumentasjonen

Utviklerne opprettet ikke dokumentasjonen selv, så det er egentlig ikke deres skyld. Som jeg sa tidligere, lagrer Dash bare eksisterende dokumentasjon.

Problemet er at noen språk bare ikke er godt dokumentert - som den forenklede JavaScript-motgiften CoffeeScript CoffeeScript er JavaScript uten hodepineJeg har aldri likt å skrive JavaScript så mye. Fra den dagen jeg skrev min første linje ved å bruke den, har jeg alltid harselet med at uansett hva jeg skriver i det alltid ender opp som en Jackson ... Les mer . Dokumentasjonen deres er mer av en "Er ikke dette kult?" hvordan å veilede, viser eksempler på språket i handling, uten egentlig å forklare hvordan ting fungerer.

Når det gjelder CoffeeScript, ser det ikke bra ut i Dash. Det passer mye bedre for en nettleser.

Når det er sagt, fungerer noen dokumentasjonssett veldig bra, som for Ruby. Dette er språket som styrer Ruby On Rails webapplikasjonsrammeverk 3 interaktive, morsomme, gratis måter å begynne å lære seg det rubin programmeringsspråketRuby er et ekspressivt, skriptspråk på høyt nivå. Den brukes hovedsakelig på nettet som en del av rammeverket for utvikling av nettet, men også frittstående. Hvis du er nysgjerrig på hva Ruby (ikke ... Les mer , har fullt søkbar dokumentasjon og passer fint innenfor Dash-estetikken.

Det er også jukseark tilgjengelig for nedlasting i Dash. Disse fokuserer ikke på språkfunksjoner, men heller på de avanserte funksjonene i Git, personalets favoritt tekstredigerer Sublime Text 2 Prøv frem sublim tekst 2 for dine behov for redigering av kode på tvers av plattformerSublime Text 2 er en kodeditor på tvers av plattformer jeg bare nylig har hørt om, og jeg må si jeg er virkelig imponert til tross for beta-etiketten. Du kan laste ned hele appen uten å betale en krone ... Les mer og 3, og andre populære programvarepakker.

Fuskark er også tilgjengelig for HTTP-funksjoner, HTML- og CSS-navngitte farger.

tilgjengelighet

Jeg kjenner mange utviklere som sliter med å lese svart tekst på hvit bakgrunn. Noen bruker til og med spesielt tonede briller for å gjøre det lettere for dem å lese. Noen trenger ganske enkelt å forstørre tekst.

Jeg har ikke funnet noen spesifikke tilgjengelighetsinnstillinger i Dash, og har heller ikke funnet noen måte å øke størrelsen på tekst på. Det kan være en avtale for noen synshemmede brukere. OS X har imidlertid noen tilgjengelighetsfunksjoner (Systemvalg> System> Tilgjengelighet) som kan gjøre Dash den litt mer brukbar.

Konklusjon

Bør du få den betalte versjonen av Dash? Det kommer an på. Det er egentlig ikke noen overbevisende funksjoner som gjør oppgraderingen verdt utgiftene, men du støtter prosjektet ved å chippe inn.

Jeg bruker gratisversjonen av Dash på nesten daglig basis. Hvis du slynger kode for levende og eier en Mac, trenger du denne appen. Det er ikke perfekt, men det får jobben gjort.

Nedlasting:Dash for Mac OS X (gratis, $ 19.99 for fullversjon)

Hva tror du? Last ned den og gi oss beskjed om tankene dine i kommentarfeltet nedenfor.

Fotokreditt: Kode (Michael Himbeault)