Hvis du er en programmør, er du allerede afhængig af dokumentationen. Dash (gratis, $ 19, 99 for fuld version) er en Mac app designet til at gøre din nødvendige læsning en mere behagelig oplevelse.
De fleste programmører kender ikke deres foretrukne sprog valg indenfor. Endnu færre prale med en detaljeret viden om hvert bibliotek og API, de kommer i kontakt med. Som programmerere vi Google. Vi spørger Stack Overflow. Vi læser dokumentation. 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 caches dokumentation fra internettet og giver dig adgang til det via en bestemt webapplikation. Den kan downloades fra Mac App Store eller udviklerwebstedet, hvor den førstnævnte har et køb i appen på 19, 99 dollar. Forskellen mellem gratis og betalt er minimal, den gratis version leveres med ventetid ved opstart, og når du skifter mellem dokumentationssæt (dokumentsæt) og vil nagre dig for at købe den.
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 udviklere).
Dashs værdiproposition er baseret på antallet af biblioteker og sprog, den understøtter, og det er her, det skinner.
Næsten meget 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 internettet både i front- og back-end-kapacitet, og alt jeg bruger er til stede her. Desværre er kvaliteten af dokumentationen lidt af en blandet taske.
Kvaliteten af dokumentation
Udviklerne skabte ikke selve dokumentationen, så det er ikke rigtig deres skyld. Som jeg sagde før, caches Dash kun eksisterende dokumentation.
Problemet er, at nogle sprog ikke er vel dokumenterede - ligesom den forenklede JavaScript-modgift CoffeeScript CoffeeScript er JavaScript uden hovedpine CoffeeScript er JavaScript uden hovedpine Jeg har aldrig rigtig godt set skrevet JavaScript så meget. Fra den dag, jeg skrev min første linje ved hjælp af den, har jeg altid irriteret det, hvad jeg skriver i det altid ender med at ligne en Jackson ... Læs mere. Deres dokumentation er mere af en "Er det ikke sejt?", Hvor vejledende, der viser eksempler på sproget i aktion, uden at forklare, hvordan tingene fungerer.
Endvidere ser det ikke godt ud i Dash, når det drejer sig om CoffeeScript. Det er meget bedre egnet til en webbrowser.
Med det sagt, arbejder nogle dokumentationssæt meget godt, ligesom dem til Ruby. Dette er sproget, der styrer Ruby On Rails webapplikationsramme 3 Interaktive, sjove og gratis måder at begynde at lære Ruby Programmeringssprog 3 Interaktive, sjove og gratis måder at begynde at lære Ruby Programmeringssprog Ruby er et ekspressivt, meget højt niveau, skriptsprog. Det bruges på internettet hovedsagelig som en del af Ruby on Rails webudviklingsrammer, men også selvstændigt. Hvis du er nysgerrig efter, hvad Ruby (ikke ... Læs mere, har fuldt søgbar dokumentation og passer fint i Dash-æstetik.
Der er også cheat ark til rådighed til download i Dash. Disse fokuserer ikke på sprogfunktioner, men snarere på de avancerede funktioner i Git, medarbejderens foretrukne tekstredigerer Sublime Tekst 2 Prøv Sublime Tekst 2 Til Din Krydsplatform Kode Redigeringsbehov Forsøg Sublime Tekst 2 Til Din Kors-Platform Kode Redigering Behøver Sublime Text 2 er en kors-platform kode editor, jeg kun for nylig hørt om, og jeg må sige, at jeg virkelig er imponeret på trods af beta-mærket. Du kan downloade den fulde app uden at betale et øre ... Læs mere og 3 og andre populære softwarepakker.
Cheat sheets er også tilgængelige for HTTP-funktioner, HTML og og CSS Named Colors.
Tilgængelighed
Jeg kender mange udviklere, der kæmper for at læse sort tekst på hvide baggrunde. Nogle bruger endda specielt tonede briller for at gøre det nemmere for dem at læse. Nogle skal blot forstørre tekst.
Jeg har ikke fundet nogen specifikke tilgængelighed indstillinger i Dash, og jeg har heller ikke fundet nogen måde at øge tekststørrelsen. Det kan være en deal-breaker for nogle synshandicappede brugere. Men OS X leveres med nogle tilgængelige funktioner ( Systemindstillinger> System> Tilgængelighed ), som kan gøre Dash den smule mere brugbar.
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 for bekostning, 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 for at leve og ejer en Mac, har du brug for denne app. Det er ikke perfekt, men det bliver jobbet gjort.
Download: 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)