Dash bringer kodedokumentasjon til Mac-skrivebordet

Hvis du er programmerer, er du allerede avhengig av dokumentasjon. Dash (gratis, $ 19,99 for fullversjon) er en Mac-app designet for å gjøre din nødvendige lesing til en mer behagelig opplevelse.

De fleste programmører kjenner ikke sitt foretrukne valg språk inne ute. Enda færre har en detaljert kunnskap om hvert bibliotek og API som de kommer i kontakt med. Som programmerere vi Google. Vi spør Stack Overflow. Vi leser dokumentasjon. Masse dokumentasjon. De fleste leser dokumentasjon i en nettleser, men det er en bedre måte. Møt Dash.

Dash og dokumentasjon

Dash er en app som lokalt caches dokumentasjon fra Internett og lar deg få tilgang til det gjennom et bestemt webprogram. Den kan lastes ned fra utviklerens nettsted. Forskjellen mellom gratis og betalt er minimal, den gratis versjonen kommer med ventetid ved oppstart og når du bytter mellom dokumentasjonssett (dokumenter) og vil nagle deg for å kjøpe det.

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

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

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

Personlig utvikler jeg meg på nettet i både 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å dokumentasjon

Utviklerne opprettet ikke dokumentasjonen selv, så det er egentlig ikke deres feil. Som jeg sa før, caster Dash bare eksisterende dokumentasjon.

Problemet er at noen språk bare ikke er godt dokumentert - som forenklet JavaScript-motgift CoffeeScript CoffeeScript er JavaScript uten hodepine CoffeeScript er JavaScript uten hodepine Jeg har aldri gøy å skrive JavaScript så mye. Fra den dagen jeg skrev min første linje ved hjelp av den, har jeg alltid irritert at det jeg skriver i alltid ender opp som en Jackson ... Les mer. Dokumentasjonen deres er mer av en “Er dette ikke kult?” how-to guide, viser eksempler på språket i handling, uten å forklare hvordan ting fungerer.

Videre, når det gjelder CoffeeScript, ser det ikke bra ut i Dash. Det er mye bedre egnet til en nettleser.

Med det sagt, fungerer noen dokumentasjonssett veldig bra, som de for Ruby. Dette er språket som driver Ruby On Rails webapplikasjonsramme. 3 Interaktive, morsomme, gratis måter å begynne å lære Ruby Programming Language 3 Interaktive, morsomme, gratis måter å begynne å lære Ruby Programming Language Ruby er et uttrykksfulle, veldig høyt nivå , skriptspråk. Den brukes på nettet hovedsakelig som en del av Ruby on Rails webutviklingsramme, men også frittstående. Hvis du er nysgjerrig på hva Ruby (ikke ... Les mer, har fullstendig søkbar dokumentasjon og passer pent inn i Dash-estetisk.

Det finnes også fuskplater tilgjengelig for nedlasting i Dash. Disse fokuserer ikke på språkfunksjoner, men heller på de avanserte funksjonene i Git, Personlig favoritt tekstredigerer Sublime Tekst 2 Prøv ut Sublime Tekst 2 For Kors-Platform Kode Redigering Trenger Prøv Sublime Tekst 2 Til Kors-Platform Kode Redigering Trenger Sublime Text 2 er en kryssplattformskodeditor som jeg nylig har hørt om, og jeg må si at jeg er veldig 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.

Cheat ark er også tilgjengelig for HTTP-funksjoner, HTML og og CSS Named Colors.

tilgjengelighet

Jeg vet mange utviklere som sliter med å lese svart tekst på hvite bakgrunner. Noen til og med bærer spesielt tonet briller for å gjøre det lettere for dem å lese. Noen trenger bare å forstørre tekst.

Jeg har ikke funnet noen spesifikke tilgjengelighetsinnstillinger i Dash, og jeg har heller ikke funnet noen måte å øke størrelsen på teksten på. Det kan være en avtale-breaker for noen synshemmede brukere. Men OS X kommer med noen tilgjengelighetsfunksjoner (Systemvalg> System> Tilgjengelighet) som kan gjøre Dash litt mer brukervennlig.

Konklusjon

Skal du få betalt versjon av Dash? Det kommer an på. Det er ikke egentlig noen overbevisende funksjoner som gjør oppgraderingen verdt bekostning, men du vil støtte prosjektet ved å chippe inn.

Jeg bruker den gratis versjonen av Dash på en daglig basis. Hvis du slår kode for å bo og eier en Mac, trenger du denne appen. Det er ikke perfekt, men det blir jobben gjort.

Nedlasting: Dash for Mac OS X (gratis, $ 19,99 for full versjon)

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

Foto Kreditt: Kode (Michael Himbeault)

Utforsk mer om: Digital Document, Programmering.