Dash porta la documentazione di codifica sul desktop del Mac

Annuncio pubblicitario

Se sei un programmatore, fai già molto affidamento sulla documentazione. trattino (gratuito, $ 19,99 per la versione completa) è un'app per Mac progettata per rendere la lettura richiesta un'esperienza più piacevole.

La maggior parte dei programmatori non conosce la lingua preferita che preferisce. Ancora meno vantano una conoscenza dettagliata di ogni libreria e API con cui entrano in contatto. Come programmatori abbiamo Google. Chiediamo Stack Overflow. Leggiamo la documentazione. Molta documentazione. La maggior parte delle persone legge la documentazione in un browser, ma esiste un modo migliore. Incontra Dash.

Dash e documentazione

Dash è un'app che memorizza nella cache locale la documentazione da Internet e consente di accedervi tramite un'applicazione Web specifica. Può essere scaricato dal sito web dello sviluppatore. La differenza tra gratuito e a pagamento è minima, la versione gratuita viene fornita con un tempo di attesa all'avvio e ogni volta che si passa da un set di documenti all'altro (docset) e si procurerà fastidio per acquistarlo.

Se scegli di eseguire l'upgrade alla versione a pagamento di Dash puoi almeno usarlo su tutti i computer Mac che possiedi (un numero illimitato, secondo gli sviluppatori).

La proposta di valore di Dash si basa sul numero di librerie e lingue supportate ed è qui che brilla.

Quasi tutte le lingue, le API e le librerie a cui puoi pensare sono rappresentate, così come alcune di cui probabilmente non hai sentito parlare. Sia web, mobile e sistema sono ben rappresentati qui.

Personalmente sviluppo per il web sia in termini di front-end che di back-end, e tutto ciò che uso è presente qui. Sfortunatamente, la qualità della documentazione è un po 'confusa.

La qualità della documentazione

Gli sviluppatori non hanno creato loro stessi la documentazione, quindi non è proprio colpa loro. Come ho detto prima, Dash memorizza solo nella cache la documentazione preesistente.

Il problema è che alcune lingue non sono ben documentate, come l'antidoto JavaScript semplificato CoffeeScript CoffeeScript è JavaScript senza mal di testaNon mi è mai piaciuto scrivere JavaScript così tanto. Dal giorno in cui ho scritto la mia prima riga usando, ho sempre risentito del fatto che qualunque cosa scrivo finisca sempre per sembrare un Jackson ... Leggi di più . La loro documentazione è più di un "Non è così bello?" guida pratica, che mostra esempi del linguaggio in azione, senza realmente spiegare Come le cose funzionano.

Inoltre, nel caso di CoffeeScript, in Dash non ha un bell'aspetto. È molto più adatto a un browser web.

Detto questo, alcuni set di documentazione funzionano molto bene, come quelli per Ruby. Questo è il linguaggio che alimenta il framework dell'applicazione Web Ruby On Rails 3 modi interattivi, divertenti e gratuiti per iniziare ad imparare il linguaggio di programmazione RubyRuby è un linguaggio di scripting espressivo, di altissimo livello. È utilizzato sul Web principalmente come parte del framework di sviluppo Web Ruby on Rails, ma anche autonomo. Se sei curioso di sapere cosa Ruby (non ... Leggi di più , ha una documentazione completamente ricercabile e si adatta perfettamente all'estetica di Dash.

Ci sono anche cheat sheet disponibili per il download in Dash. Questi non si concentrano sulle funzionalità del linguaggio, ma piuttosto sulle funzionalità avanzate di Git, editor di testi preferito dallo staff Sublime Text 2 Prova Sublime Text 2 per le tue esigenze di modifica del codice multipiattaformaSublime Text 2 è un editor di codice multipiattaforma di cui ho sentito parlare solo di recente e devo dire che sono rimasto davvero colpito nonostante l'etichetta beta. Puoi scaricare l'app completa senza pagare un centesimo ... Leggi di più e 3 e altri pacchetti software popolari.

I cheat sheet sono disponibili anche per le funzioni HTTP, i colori con nome HTML e CSS.

Accessibilità

Conosco molti sviluppatori che fanno fatica a leggere testi neri su sfondi bianchi. Alcuni addirittura indossano occhiali appositamente colorati per facilitare la lettura. Alcuni hanno semplicemente bisogno di ingrandire il testo.

Non ho trovato impostazioni di accessibilità specifiche in Dash, né ho trovato alcun modo per aumentare le dimensioni del testo. Potrebbe essere un problema per alcuni utenti ipovedenti. Tuttavia, OS X include alcune funzionalità di accessibilità (Preferenze di Sistema> Sistema> Accessibilità) che potrebbe rendere Dash un po 'più utilizzabile.

Conclusione

Dovresti ottenere la versione a pagamento di Dash? Dipende. In realtà non ci sono caratteristiche convincenti che valgono la spesa per l'aggiornamento, ma supporterai il progetto intervenendo.

Uso la versione gratuita di Dash quasi quotidianamente. Se il codice di imbracatura per vivere e possedere un Mac, è necessaria questa app. Non è perfetto, ma fa il lavoro.

Scarica:Dash per Mac OS X (gratuito, $ 19,99 per la versione completa)

Cosa ne pensi? Scaricalo e facci sapere cosa ne pensi nei commenti qui sotto.

Diritti d'autore della foto: Codice (Michael Himbeault)