Dash brengt coderingsdocumentatie naar de Mac Desktop

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 uw vereiste leeservaring aangenamer te maken.

De meeste programmeurs kennen hun voorkeurstaal niet van binnenuit. Nog minder beschikken over een gedetailleerde kennis van elke bibliotheek en API waarmee ze in contact komen. Als programmeurs die we Google gebruiken. We vragen Stack Overflow. We lezen documentatie. Veel en 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 documentatie lokaal van internet opslaat en u via een specifieke webtoepassing toegang geeft. Het kan worden gedownload van de website van de ontwikkelaar. Het verschil tussen gratis en betaald is minimaal, de gratis versie wordt geleverd met een wachttijd bij het opstarten en wanneer u tussen documentatiesets (docsets) wisselt en u zult zeuren om het te kopen.

Als u ervoor kiest om naar de betaalde versie van Dash te upgraden, kunt u het op zijn minst gebruiken op zoveel Mac-computers als u bezit (een onbeperkt aantal, volgens ontwikkelaars).

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

Vrijwel elke taal, API en bibliotheek die je kunt bedenken, is vertegenwoordigd, evenals een aantal waar je waarschijnlijk nog nooit van hebt gehoord. Zowel internet, mobiel als systeem zijn hier goed vertegenwoordigd.

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

De kwaliteit van documentatie

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

Het probleem is dat sommige talen gewoon niet goed gedocumenteerd zijn - zoals het vereenvoudigde JavaScript-tegengif. CoffeeScript CoffeeScript is JavaScript zonder de hoofdpijn CoffeeScript is JavaScript zonder de hoofdpijn Ik heb nog nooit zo veel van JavaScript geschreven. Vanaf de dag dat ik mijn eerste regel schreef, heb ik er altijd tegenin gezeten dat alles wat ik erin schrijf altijd eruitziet als een Jackson ... Lees meer. Hun documentatie is meer van een “Is dit niet cool??” handleiding, voorbeelden van de taal in actie laten zien, zonder iets uit te leggen hoe dingen werken.

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

Met dat gezegd, werken sommige documentatiesets heel goed, zoals die voor Ruby. Dit is de taal die het Ruby On Rails-webapplicatiekader aanstuurt 3 Interactieve, leuke, vrije manieren om te leren De Ruby programmeertaal 3 Interactief, leuk, gratis manieren om te leren De Ruby programmeertaal Ruby is een expressieve, zeer hoog niveau , scripttaal. Het wordt voornamelijk op internet gebruikt als onderdeel van het webontwikkelingskader van Ruby on Rails, maar ook als standalone. Als je nieuwsgierig bent naar wat Ruby (niet ... Lees meer, heeft volledig doorzoekbare documentatie en past mooi in de Dash-esthetiek.

Er zijn ook spiekbriefjes beschikbaar om te downloaden in Dash. Deze richten zich niet op taalfuncties, maar veeleer op de geavanceerde functies van Git, personeel favoriete teksteditor Sublime Text 2 Try Out Sublime Text 2 voor uw platformonafhankelijke codebewerkingsbehoeften Probeer uit sublieme tekst 2 voor uw codewijzigingen op verschillende platforms Behoeft Sublime Tekst 2 is een platformonafhankelijke codebewerker waar ik pas sinds kort over hoorde, en ik moet zeggen dat ik erg onder de indruk ben ondanks het bèta-label. Je kunt de volledige app downloaden zonder een cent te betalen ... Lees meer en 3 en andere populaire softwarepakketten.

Cheatsheets 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 speciaal getinte brillen om het voor hen gemakkelijker te maken om te lezen. Sommigen moeten gewoon de tekst 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 gebruikers met een visuele beperking. OS X wordt echter geleverd met enkele toegankelijkheidsfuncties (Systeemvoorkeuren> Systeem> Toegankelijkheid) die Dash dat beetje bruikbaarder zouden kunnen maken.

Conclusie

Krijgt u de betaalde versie van Dash? Dat hangt ervan af. Er zijn niet echt aantrekkelijke eigenschappen die de upgrade de moeite waard maken, maar je zult het project ondersteunen door in te chippen.

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

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

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

Photo Credit: Code (Michael Himbeault)

Ontdek meer over: Digitaal document, Programmeren.