Advertentie

Als je een programmeur bent, ben je al sterk afhankelijk van documentatie. Dash (gratis, $ 19,99 voor de volledige versie) is een Mac-app die is ontworpen om je leesplezier aangenamer te maken.

De meeste programmeurs kennen hun voorkeurstaal van binnen en van buiten niet. Nog minder beschikken over een gedetailleerde kennis van elke bibliotheek en API waarmee ze in aanraking komen. Als programmeurs Google. We vragen Stack Overflow. We lezen documentatie. Heel veel documentatie. De meeste mensen lezen documentatie in een browser, maar er is een betere manier. Maak kennis met Dash.

Dash en documentatie

Dash is een app die lokaal documentatie van internet opslaat en u toegang geeft via een specifieke webtoepassing. Het kan worden gedownload van de website voor ontwikkelaars. Het verschil tussen gratis en betaald is minimaal, de gratis versie wordt geleverd met een wachttijd bij het opstarten en wanneer u wisselt tussen documentatiesets (docsets) en zal u zeuren om het te kopen.

dash-nag

Als je ervoor kiest om te upgraden naar de betaalde versie van Dash, kun je deze in ieder geval gebruiken op zoveel Mac-computers als je bezit (een onbeperkt aantal, volgens ontwikkelaars).

instagram viewer

Het waardevoorstel van Dash is gebaseerd op het aantal bibliotheken en talen dat het ondersteunt, en hier schittert het.

dash-docsets

Vrijwel elke taal, API en bibliotheek die u kunt bedenken, is vertegenwoordigd, evenals sommige waarvan u waarschijnlijk nog nooit hebt gehoord. Zowel web, mobiel als systeem zijn hier goed vertegenwoordigd.

Persoonlijk ontwikkel ik voor het web in zowel front- als back-end capaciteit, en alles wat ik gebruik is hier aanwezig. Helaas is de kwaliteit van de documentatie een beetje een allegaartje.

De kwaliteit van documentatie

De ontwikkelaars hebben de documentatie niet zelf gemaakt, dus het is niet echt hun schuld. Zoals ik eerder zei, slaat Dash alleen de reeds bestaande documentatie op.

Het probleem is dat sommige talen gewoon niet goed gedocumenteerd zijn, zoals het vereenvoudigde JavaScript-tegengif CoffeeScript CoffeeScript is JavaScript zonder hoofdpijnIk heb nooit echt van JavaScript gehouden. Vanaf de dag dat ik mijn eerste regel schreef, heb ik het altijd kwalijk genomen dat wat ik erin schrijf er altijd uitziet als een Jackson ... Lees verder . Hun documentatie is meer een "Is dit niet cool?" how-to guide, voorbeelden van de taal in actie laten zien, zonder daadwerkelijk uit te leggen hoe dingen werken.

dash-koffie

Bovendien ziet het er in het geval van CoffeeScript niet goed uit in Dash. Het is veel beter geschikt voor een webbrowser.

Dat gezegd hebbende, werken sommige documentatiesets heel goed, zoals die voor Ruby. Dit is de taal die het Ruby On Rails-webapplicatiekader ondersteunt 3 Interactieve, leuke, gratis manieren om de programmeertaal Ruby te lerenRuby is een expressieve scripttaal van zeer hoog niveau. Het wordt op het web voornamelijk gebruikt als onderdeel van het Ruby on Rails-webontwikkelingsraamwerk, maar ook zelfstandig. Als je nieuwsgierig bent naar wat Ruby (niet ... Lees verder , heeft volledig doorzoekbare documentatie en past mooi binnen de Dash-esthetiek.

dash-rb

Er zijn ook spiekbriefjes beschikbaar om te downloaden in Dash. Deze richten zich niet op taalfuncties, maar eerder op de geavanceerde functies van Git, personeel favoriete teksteditor Sublime Text 2 Probeer Sublime Text 2 uit voor uw platformonafhankelijke bewerkingsbehoeftenSublime Text 2 is een platformonafhankelijke code-editor waar ik pas onlangs van gehoord heb, en ik moet zeggen dat ik ondanks het bètalabel echt onder de indruk ben. U kunt de volledige app downloaden zonder een cent te betalen ... Lees verder en 3, en andere populaire softwarepakketten.

Cheat-sheets zijn ook beschikbaar voor HTTP-functies, HTML en en CSS Named Colors.

Toegankelijkheid

Ik ken veel ontwikkelaars die moeite hebben om zwarte tekst op een witte achtergrond te lezen. Sommigen dragen zelfs een speciaal getinte bril om het lezen gemakkelijker te maken. Sommigen hoeven alleen maar de tekst te vergroten.

Ik heb geen specifieke toegankelijkheidsinstellingen gevonden in Dash en ik heb ook geen manier gevonden om de tekst groter te maken. Dat kan een deal-breaker zijn voor sommige visueel gehandicapte gebruikers. OS X wordt echter geleverd met enkele toegankelijkheidsfuncties (Systeemvoorkeuren> Systeem> Toegankelijkheid) wat Dash net dat beetje meer bruikbaar zou kunnen maken.

Conclusie

Moet je de betaalde versie van Dash krijgen? Dat hangt ervan af. Er zijn niet echt boeiende functies die de upgrade de kosten waard maken, maar u steunt het project door in te chippen.

Ik gebruik de gratis versie van Dash bijna dagelijks. Als je code voor de kost slingert en een Mac bezit, heb je deze app nodig. Het is niet perfect, maar het klopt.

Downloaden:Dash voor Mac OS X (gratis, $ 19,99 voor de volledige versie)

Wat denk je? Download het en laat ons uw mening weten in de opmerkingen hieronder.

Fotocredit: Code (Michael Himbeault)

Matthew Hughes is een softwareontwikkelaar en schrijver uit Liverpool, Engeland. Hij wordt zelden gevonden zonder een kopje sterke zwarte koffie in zijn hand en is dol op zijn Macbook Pro en zijn camera. Je kunt zijn blog lezen op http://www.matthewhughes.co.uk en volg hem op twitter op @matthewhughes.