Si vous êtes programmeur, vous dépendez déjà fortement de la documentation. Dash (gratuit, 19, 99 $ pour la version complète) est une application Mac conçue pour rendre votre lecture nécessaire une expérience plus agréable.
La plupart des programmeurs ne connaissent pas la langue de leur choix. Encore moins se vanter d'une connaissance détaillée de chaque bibliothèque et API qu'ils entrent en contact avec. En tant que programmeurs nous Google. Nous demandons Stack Overflow. Nous lisons la documentation. Beaucoup et beaucoup de documentation. La plupart des gens lisent la documentation dans un navigateur, mais il existe une meilleure solution. Rencontrez Dash.
Tableau de bord et documentation
Dash est une application qui met en cache localement la documentation provenant d'Internet et vous permet d'y accéder via une application Web spécifique. Il peut être téléchargé depuis le Mac App Store ou le site Web du développeur, le premier proposant un achat in-app de 19, 99 $. La différence entre gratuit et payant est minime, la version gratuite s'accompagne d'un temps d'attente au démarrage et chaque fois que vous passez d'un jeu de documentation à un autre (docsets) et que vous l'achetez.
Si vous choisissez de passer à la version payante de Dash, vous pouvez au moins l'utiliser sur autant d'ordinateurs Mac que vous possédez (un nombre illimité, selon les développeurs).
La proposition de valeur de Dash est basée sur le nombre de bibliothèques et de langues qu'il supporte, et c'est ici qu'il brille.
Presque toutes les langues, API et bibliothèques auxquelles vous pouvez penser sont représentées, ainsi que certaines dont vous n'avez probablement jamais entendu parler. Les deux Web, mobile et système sont bien représentés ici.
Personnellement, je développe pour le web à la fois une capacité avant et arrière, et tout ce que j'utilise est présent ici. Malheureusement, la qualité de la documentation est un peu mitigée.
La qualité de la documentation
Les développeurs n'ont pas créé la documentation eux-mêmes, donc ce n'est pas vraiment leur faute. Comme je l'ai déjà dit, Dash ne met en cache que la documentation préexistante.
Le problème est que certaines langues ne sont pas bien documentées - comme l'antidote Javascript simplifié CoffeeScript CoffeeScript est JavaScript sans les maux de tête CoffeeScript est JavaScript sans les maux de tête Je n'ai jamais vraiment aimé écrire du JavaScript. A partir du jour où j'ai écrit ma première ligne en l'utilisant, j'ai toujours ressenti que tout ce que j'écris finit toujours par ressembler à un Jackson ... Lire la suite. Leur documentation est plus d'un guide pratique "n'est-ce pas cool?", Montrant des exemples de la langue en action, sans réellement expliquer comment les choses fonctionnent.
En outre, dans le cas de CoffeeScript, il ne semble pas bon dans Dash. C'est beaucoup mieux adapté à un navigateur Web.
Cela dit, certains ensembles de documentation fonctionnent très bien, comme ceux de Ruby. C'est le langage qui alimente le framework d'application web Ruby On Rails 3 Des moyens interactifs, amusants et gratuits pour commencer à apprendre le langage de programmation Ruby 3 Des moyens interactifs, amusants et gratuits pour commencer à apprendre Le langage de programmation Ruby Ruby est expressif, très haut niveau, langage de script. Il est principalement utilisé sur le Web dans le cadre du développement web de Ruby on Rails, mais aussi de façon autonome. Si vous êtes curieux de savoir ce que Ruby (pas ... Lire la suite, a une documentation entièrement consultable et s'intègre bien dans l'esthétique Dash.
Il y a aussi des feuilles de triche à télécharger dans Dash. Ceux-ci ne se concentrent pas sur les fonctionnalités du langage, mais plutôt sur les fonctionnalités avancées de Git, éditeur de texte préféré du personnel Sublime Text 2 Essayez Sublime Text 2 Pour vos besoins d'édition de code multiplateforme Essayez Text Sublime 2 Pour votre édition de code multiplateforme Needs Sublime Text 2 est un éditeur de code multiplateforme dont je n'ai entendu parler que récemment, et je dois dire que je suis vraiment impressionné malgré le label bêta. Vous pouvez télécharger l'application complète sans payer un centime ... Lire la suite et 3, et d'autres progiciels populaires.
Les feuilles de triche sont également disponibles pour les fonctionnalités HTTP, HTML et CSS et les couleurs nommées.
Accessibilité
Je connais beaucoup de développeurs qui luttent pour lire du texte noir sur fond blanc. Certains portent même des lunettes spécialement teintées pour faciliter leur lecture. Certains ont simplement besoin d'agrandir le texte.
Je n'ai trouvé aucun paramètre d'accessibilité spécifique dans Dash, et je n'ai trouvé aucun moyen d'augmenter la taille du texte. Cela pourrait être un bris d'accord pour certains utilisateurs malvoyants. Cependant, OS X est livré avec certaines fonctionnalités d'accessibilité ( Préférences Système> Système> Accessibilité ) qui pourraient rendre le Dash un peu plus utilisable.
Conclusion
Devriez-vous obtenir la version payante de Dash? Ça dépend. Il n'y a pas vraiment de caractéristiques convaincantes qui font que la mise à niveau en vaut la peine, mais vous soutenez le projet en l'intégrant.
J'utilise la version gratuite de Dash presque tous les jours. Si vous sling code pour vivre et posséder un Mac, vous avez besoin de cette application. Ce n'est pas parfait, mais ça fait le boulot.
Télécharger: Dash pour Mac OS X (gratuit, 19, 99 $ pour la version complète)
Qu'est-ce que tu penses? Téléchargez-le et laissez-nous savoir vos pensées dans les commentaires, ci-dessous.
Crédit photo: Code (Michael Himbeault)