Publicité
Si vous êtes programmeur, vous comptez déjà beaucoup sur la documentation. Tiret (gratuit, 19,99 $ pour la version complète) est une application Mac conçue pour rendre votre lecture requise une expérience plus agréable.
La plupart des programmeurs ne connaissent pas parfaitement la langue de leur choix. Encore moins disposent d'une connaissance détaillée de chaque bibliothèque et API avec laquelle ils entrent en contact. En tant que programmeurs, nous Google. Nous demandons Stack Overflow. Nous lisons la documentation. Beaucoup, beaucoup de documentation. La plupart des gens lisent la documentation dans un navigateur, mais il existe un meilleur moyen. Rencontrez Dash.
Dash et documentation
Dash est une application qui met en cache localement la documentation sur Internet et vous permet d'y accéder via une application Web spécifique. Il peut être téléchargé sur site développeur. La différence entre gratuit et payant est minime, la version gratuite est livrée avec un temps d'attente au démarrage et chaque fois que vous basculez entre les ensembles de documentation (docsets) et vous harcèlera pour l'acheter.

Si vous choisissez de passer à la version payante de Dash, vous pouvez au moins l'utiliser sur autant d'ordinateurs Mac que vous en 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'elle prend en charge, et c'est ici qu'elle 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. Le Web, le mobile et le système sont bien représentés ici.
Personnellement, je développe pour le web à la fois en front et en back-end, 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, ce n'est donc 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 tout simplement pas bien documentées - comme l'antidote JavaScript simplifié CoffeeScript CoffeeScript est JavaScript sans les maux de têteJe n'ai jamais autant aimé écrire JavaScript. Depuis le jour où j'ai écrit ma première ligne en l'utilisant, j'ai toujours ressenti que tout ce que j'écris dedans finit toujours par ressembler à un Jackson ... Lire la suite . Leur documentation est plus un "N'est-ce pas cool?" guide pratique, montrant des exemples du langage en action, sans vraiment expliquer Comment les choses fonctionnent.

De plus, dans le cas de CoffeeScript, cela ne semble pas bon dans Dash. Il 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 cadre d'application Web Ruby On Rails 3 façons interactives, amusantes et gratuites de commencer à apprendre le langage de programmation RubyRuby est un langage de script expressif de très haut niveau. Il est utilisé sur le Web principalement dans le cadre du cadre de développement Web Ruby on Rails, mais également de manière autonome. Si vous êtes curieux de savoir ce que Ruby (pas ... Lire la suite , a une documentation entièrement consultable et s'intègre parfaitement dans l'esthétique Dash.

Il existe également des feuilles de triche disponibles en téléchargement dans Dash. Ceux-ci ne se concentrent pas sur les fonctionnalités linguistiques, 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 multiplateformeSublime 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é l'étiquette bêta. Vous pouvez télécharger l'application complète sans payer un sou ... Lire la suite et 3, et d'autres progiciels populaires.
Des astuces sont également disponibles pour les fonctionnalités HTTP, les couleurs nommées HTML et CSS.
Accessibilité
Je connais beaucoup de développeurs qui ont du mal à lire du texte noir sur fond blanc. Certains portent même des lunettes teintées spécialement 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 une rupture pour certains utilisateurs malvoyants. Cependant, OS X est livré avec certaines fonctionnalités d'accessibilité (Préférences système> Système> Accessibilité), ce qui pourrait rendre Dash un peu plus utilisable.
Conclusion
Devriez-vous obtenir la version payante de Dash? Ça dépend. Il n'y a pas vraiment de fonctionnalités convaincantes qui valent la dépense, mais vous soutiendrez le projet en participant.
J'utilise la version gratuite de Dash presque quotidiennement. Si vous utilisez du code pour gagner votre vie et que vous possédez un Mac, vous avez besoin de cette application. Ce n’est pas parfait, mais cela fait le travail.
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 faites-nous part de vos réflexions dans les commentaires ci-dessous.
Crédit photo: Code (Michael Himbeault)
Matthew Hughes est un développeur de logiciels et écrivain de Liverpool, en Angleterre. Il est rarement trouvé sans une tasse de café noir fort dans sa main et adore absolument son Macbook Pro et son appareil photo. Vous pouvez lire son blog sur http://www.matthewhughes.co.uk et suivez-le sur twitter à @matthewhughes.