Dash bringt Codierungsdokumentation auf den Mac Desktop

Werbung

Wenn Sie Programmierer sind, verlassen Sie sich bereits stark auf Dokumentation. Strich (kostenlos, 19,99 USD für die Vollversion) ist eine Mac-App, mit der Sie das gewünschte Lesen angenehmer gestalten können.

Die meisten Programmierer kennen ihre bevorzugte Sprache nicht genau. Noch weniger verfügen über detaillierte Kenntnisse über jede Bibliothek und API, mit der sie in Kontakt kommen. Als Programmierer googeln wir. Wir bitten um Stapelüberlauf. Wir lesen die Dokumentation. Viele, viele Dokumentationen. Die meisten Leute lesen die Dokumentation in einem Browser, aber es gibt einen besseren Weg. Treffen Sie Dash.

Dash und Dokumentation

Dash ist eine App, die Dokumentation lokal aus dem Internet zwischenspeichert und Ihnen den Zugriff über eine bestimmte Webanwendung ermöglicht. Es kann von der heruntergeladen werden Entwickler-Website. Der Unterschied zwischen kostenlos und kostenpflichtig ist minimal. Die kostenlose Version hat eine Wartezeit beim Start und immer dann, wenn Sie zwischen Dokumentationssätzen (Docsets) wechseln und Sie zum Kauf auffordern.

Wenn Sie sich für ein Upgrade auf die kostenpflichtige Version von Dash entscheiden, können Sie es mindestens auf so vielen Mac-Computern verwenden, wie Sie besitzen (laut Entwicklern eine unbegrenzte Anzahl).

Das Wertversprechen von Dash basiert auf der Anzahl der unterstützten Bibliotheken und Sprachen, und hier leuchtet es.

Nahezu jede Sprache, API und Bibliothek, an die Sie denken können, ist vertreten, ebenso wie einige, von denen Sie wahrscheinlich noch nichts gehört haben. Sowohl Web als auch Mobile und System sind hier gut vertreten.

Persönlich entwickle ich sowohl im Front- als auch im Back-End-Bereich für das Web, und alles, was ich benutze, ist hier vorhanden. Leider ist die Qualität der Dokumentation etwas uneinheitlich.

Die Qualität der Dokumentation

Die Entwickler haben die Dokumentation nicht selbst erstellt, es ist also nicht wirklich ihre Schuld. Wie ich bereits sagte, speichert Dash nur bereits vorhandene Dokumentationen zwischen.

Das Problem ist, dass einige Sprachen einfach nicht gut dokumentiert sind das vereinfachte JavaScript-Gegenmittel CoffeeScript CoffeeScript ist JavaScript ohne KopfschmerzenIch habe noch nie so gerne JavaScript geschrieben. Von dem Tag an, an dem ich meine erste Zeile damit geschrieben habe, habe ich mich immer darüber geärgert, dass alles, was ich darin schreibe, immer wie ein Jackson aussieht ... Weiterlesen . Ihre Dokumentation ist eher ein "Ist das nicht cool?" Anleitung, die Beispiele der Sprache in Aktion zeigt, ohne sie tatsächlich zu erklären Wie Dinge funktionieren.

Außerdem sieht es im Fall von CoffeeScript in Dash nicht gut aus. Es ist viel besser für einen Webbrowser geeignet.

Trotzdem funktionieren einige Dokumentationssätze sehr gut, wie die für Ruby. Das ist Die Sprache, die das Ruby On Rails-Webanwendungsframework unterstützt 3 Interaktive, unterhaltsame und kostenlose Möglichkeiten zum Erlernen der Ruby-ProgrammierspracheRuby ist eine ausdrucksstarke Skriptsprache auf sehr hohem Niveau. Es wird im Web hauptsächlich als Teil des Ruby on Rails-Webentwicklungsframeworks verwendet, ist aber auch eigenständig. Wenn Sie neugierig sind, was Ruby (nicht ... Weiterlesen , hat eine vollständig durchsuchbare Dokumentation und passt gut in die Dash-Ästhetik.

Es gibt auch Spickzettel zum Herunterladen in Dash. Diese konzentrieren sich nicht auf Sprachfunktionen, sondern auf die erweiterten Funktionen von Git. Mitarbeiter Lieblings-Texteditor Sublime Text 2 Probieren Sie Sublime Text 2 für Ihre plattformübergreifenden Anforderungen an die Codebearbeitung ausSublime Text 2 ist ein plattformübergreifender Code-Editor, von dem ich erst kürzlich gehört habe, und ich muss sagen, dass ich trotz des Beta-Labels wirklich beeindruckt bin. Sie können die vollständige App herunterladen, ohne einen Cent zu zahlen ... Weiterlesen und 3 und andere beliebte Softwarepakete.

Spickzettel sind auch für HTTP-Funktionen, HTML- und CSS-benannte Farben verfügbar.

Barrierefreiheit

Ich kenne viele Entwickler, die Schwierigkeiten haben, schwarzen Text auf weißem Hintergrund zu lesen. Einige tragen sogar eine speziell getönte Brille, um das Lesen zu erleichtern. Einige müssen lediglich den Text vergrößern.

Ich habe weder bestimmte Einstellungen für die Barrierefreiheit in Dash gefunden noch eine Möglichkeit gefunden, die Textgröße zu erhöhen. Dies könnte für einige sehbehinderte Benutzer ein Deal-Breaker sein. OS X verfügt jedoch über einige Eingabehilfen (Systemeinstellungen> System> Barrierefreiheit), was Dash ein bisschen benutzerfreundlicher machen könnte.

Fazit

Sollten Sie die kostenpflichtige Version von Dash erhalten? Kommt darauf an. Es gibt nicht wirklich überzeugende Funktionen, die das Upgrade die Kosten wert machen, aber Sie werden das Projekt unterstützen, indem Sie sich einschalten.

Ich benutze die kostenlose Version von Dash fast täglich. Wenn Sie Code für Ihren Lebensunterhalt schleudern und einen Mac besitzen, benötigen Sie diese App. Es ist nicht perfekt, aber es erledigt den Job.

Herunterladen:Dash für Mac OS X. (kostenlos, 19,99 $ für die Vollversion)

Was denken Sie? Laden Sie es herunter und teilen Sie uns Ihre Meinung in den Kommentaren unten mit.

Fotokredit: Code (Michael Himbeault)