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 Mac App Store of ontwikkelaarswebsite, waarbij de eerste een in-app-aankoop van $ 19, 99 bevat. Het verschil tussen gratis en betaald is minimaal, de gratis versie wordt geleverd met een wachttijd bij het opstarten en telkens wanneer u tussen documentatiesets (docsets) wisselt en u zult zeuren om het te kopen.
Als je ervoor kiest om te upgraden naar de betaalde versie van Dash, kun je deze op zijn minst gebruiken op zoveel Mac-computers als je bezit (volgens ontwikkelaars een onbeperkt aantal).
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 een "Is dit niet cool?" Handleiding, laat voorbeelden zien van de taal in actie, zonder eigenlijk uit te leggen hoe de 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.
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 speciaal getinte brillen om het voor hen gemakkelijker te maken om te lezen. Sommige hoeven alleen maar om 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 gebruikers met een visuele beperking. OS X wordt echter geleverd met een aantal toegankelijkheidsfuncties ( Systeemvoorkeuren> Systeem> Toegankelijkheid ), waardoor Dash misschien wat bruikbaarder wordt.
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.
Downloaden: Dash voor Mac OS X (gratis, $ 19, 99 voor de volledige versie)
Wat denk je? Download het en laat het ons weten in de opmerkingen hieronder.
Photo Credit: Code (Michael Himbeault)