Se sei un programmatore, fai già molto affidamento sulla documentazione. Dash (gratuito, $ 19, 99 per la versione completa) è un'app per Mac progettata per rendere la tua lettura richiesta un'esperienza più piacevole.
La maggior parte dei programmatori non conosce la lingua preferita da preferire. Ancora meno vantano una conoscenza dettagliata di ogni libreria e API con cui entrano in contatto. Come programmatori noi di Google. Chiediamo Stack Overflow. Leggiamo la documentazione. Tanta e tanta documentazione. La maggior parte delle persone legge la documentazione in un browser, ma c'è un modo migliore. Ti presento Dash.
Dash e documentazione
Dash è un'app che localmente memorizza nella cache la documentazione da Internet e ti consente di accedervi tramite una specifica applicazione web. Può essere scaricato dal Mac App Store o dal sito Web degli sviluppatori, con il primo con un acquisto in-app di $ 19, 99. La differenza tra free e paid è minima, la versione gratuita viene fornita con un tempo di attesa all'avvio e ogni volta che si passa da un set di documentazione (docset) e si è costretti ad 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.
Praticamente tutte le lingue, le API e le librerie che puoi immaginare sono rappresentate, così come alcune che probabilmente non hai mai sentito nominare. Sia web, mobile e sistema sono ben rappresentati qui.
Personalmente sviluppo per il web sia in una capacità di front e back-end, e tutto ciò che uso è presente qui. Sfortunatamente, la qualità della documentazione è un po 'mista.
La qualità della documentazione
Gli sviluppatori non hanno creato la documentazione da soli, quindi non è proprio colpa loro. Come ho detto prima, Dash memorizza solo la documentazione preesistente.
Il problema è che alcune lingue non sono ben documentate - come l'antidoto JavaScript semplificato CoffeeScript CoffeeScript È JavaScript senza i mal di testa CoffeeScript È JavaScript senza i mal di testa Non mi è mai piaciuto scrivere JavaScript così tanto. Dal giorno in cui ho scritto la mia prima linea usandola, mi sono sempre dispiaciuto per il fatto che qualsiasi cosa io scriva in essa finisce sempre per sembrare un Jackson ... Read More. La loro documentazione è più di un "Non è bello?" Come guida, mostrando esempi del linguaggio in azione, senza in realtà spiegare come funzionano le cose.
Inoltre, nel caso di CoffeeScript, non ha un bell'aspetto in Dash. È 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 per applicazioni web di Ruby On Rails 3 Interactive, Fun, Free Ways per iniziare l'apprendimento del linguaggio di programmazione di Ruby 3 Interactive, Fun, Free Ways per iniziare l'apprendimento del linguaggio di programmazione Ruby Ruby è un espressivo, di altissimo livello, linguaggio di scripting. Viene utilizzato sul Web principalmente come parte del framework di sviluppo web di Ruby on Rails, ma anche standalone. Se sei curioso di sapere cosa Ruby (non ... Read More, ha una documentazione completamente ricercabile e si adatta perfettamente all'estetica di Dash.
Ci sono anche i trucchi disponibili per il download in Dash. Questi non si concentrano sulle funzionalità linguistiche, ma piuttosto sulle funzionalità avanzate di Git, editor di testo preferito del personale. Sublime Text 2 Prova Outlime Text 2 per il tuo codice multipiattaforma Modifica dei bisogni Prova Sublime Text 2 per la modifica del codice multipiattaforma Needs Sublime Text 2 è un editor di codice multipiattaforma di cui ho sentito parlare solo di recente, e devo dire che sono davvero impressionato nonostante l'etichetta beta. Puoi scaricare l'app completa senza pagare un centesimo ... Leggi altro e 3 e altri pacchetti software popolari.
I cheat sheet sono disponibili anche per le funzioni HTTP, HTML e CSS Named Colors.
Accessibilità
Conosco molti sviluppatori che hanno difficoltà a leggere il testo nero su sfondi bianchi. Alcuni addirittura indossano occhiali colorati per renderli più facili da leggere. Alcuni hanno semplicemente bisogno di ingrandire il testo.
Non ho trovato alcuna specifica impostazione di accessibilità in Dash, né ho trovato alcun modo per aumentare la dimensione del testo. Questo potrebbe essere un affare per alcuni utenti ipovedenti. Tuttavia, OS X è dotato di alcune funzioni di accessibilità ( Preferenze di Sistema> Sistema> Accessibilità ) che potrebbero rendere Dash un po 'più utilizzabile.
Conclusione
Dovresti ottenere la versione a pagamento di Dash? Dipende. Non ci sono davvero caratteristiche convincenti che rendano l'upgrade degno di nota, ma sosterrai il progetto scheggiandoti.
Uso la versione gratuita di Dash su base giornaliera. Se sei un codice fionda per vivere e possedere un Mac, hai bisogno di questa app. Non è perfetto, ma ha fatto il lavoro.
Download: Dash per Mac OS X (gratuito, $ 19, 99 per la versione completa)
Cosa ne pensi? Scaricalo e facci sapere i tuoi pensieri nei commenti, di seguito.
Credito fotografico: Codice (Michael Himbeault)