Dash prináša kódovanie dokumentácie na plochu Mac

Reklama

Ak ste programátor, už sa veľmi spoliehate na dokumentáciu. pomlčka (zdarma, 19,99 dolárov v plnej verzii) je aplikácia pre Mac navrhnutá tak, aby vaše požadované čítanie spríjemnilo zážitok.

Väčšina programátorov nepozná preferovaný jazyk výberu zvnútra. Ešte menej sa môže pochváliť podrobnými znalosťami každej knižnice a API, s ktorými prichádzajú do styku. Ako programátori sme Google. Žiadame Stack Overflow. Čítali sme dokumentáciu. Veľa a veľa dokumentácie. Väčšina ľudí číta dokumentáciu v prehliadači, ale existuje lepší spôsob. Zoznámte sa s Dashom.

Pomlčka a dokumentácia

Dash je aplikácia, ktorá lokálne ukladá dokumentáciu z Internetu do medzipamäte a umožňuje vám k nej prístup prostredníctvom konkrétnej webovej aplikácie. Môžete si ho stiahnuť z internetu webová stránka pre vývojárov. Rozdiel medzi bezplatnou a platenou je minimálny, bezplatná verzia prichádza s čakacím časom pri štarte a vždy, keď prepínate medzi súbormi dokumentácie (docsets) a budete vás chcieť kúpiť.

Ak sa rozhodnete upgradovať na platenú verziu Dash, môžete ju použiť aspoň na tom istom počte počítačov Mac, koľko vlastníte (podľa vývojárov neobmedzený počet).

Cenová ponuka spoločnosti Dash je založená na počte knižníc a jazykov, ktoré podporuje, a práve tu svieti.

Je tu zastúpený takmer každý jazyk, rozhranie API a knižnica, ako aj niektoré z nich, o ktorých ste pravdepodobne ešte nepočuli. Web, mobil a systém sú tu dobre zastúpené.

Osobne vyvíjam pre web v prednej aj zadnej-end kapacity, a všetko, čo používam, je tu. Kvalita dokumentácie je, bohužiaľ, trochu zmiešaná.

Kvalita dokumentácie

Vývojári sami nevytvorili dokumentáciu, takže to v skutočnosti nie je ich chyba. Ako som už povedal, Dash ukladá do pamäte cache iba existujúcu dokumentáciu.

Problém je v tom, že niektoré jazyky nie sú dobre zdokumentované - napríklad zjednodušené skriptovanie protilátok proti skriptu JavaScript CoffeeScript je JavaScript bez bolesti hlavyNikdy sa mi veľmi nepáčilo písať JavaScript. Odo dňa, keď som napísal svoj prvý riadok, ktorý ho používal, som vždycky namietal, že všetko, čo v ňom napíšem, vždy vyzerá ako Jackson ... Čítaj viac . Ich dokumentácia je skôr „nie je to super?“ návod na použitie, ukážky príkladov jazyka v praxi, bez toho, aby sa to skutočne vysvetľovalo ako veci fungujú.

Okrem toho v prípade jazyka JavaScript nie je v Dash dobre. Je to oveľa vhodnejšie pre webový prehľadávač.

Niektoré súbory dokumentácie fungujú veľmi dobre, napríklad pre Ruby. Toto je jazyk, ktorý poháňa rámec webovej aplikácie Ruby On Rails 3 interaktívne, zábavné a bezplatné spôsoby, ako začať učiť programovací jazyk RubyRuby je výrazný skriptovací jazyk na vysokej úrovni. Používa sa na webe hlavne ako súčasť rámca pre vývoj webových aplikácií Ruby on Rails, ale tiež ako samostatný nástroj. Ak vás zaujíma, čo Ruby (nie ... Čítaj viac , má plne prehľadávateľnú dokumentáciu a pekne zapadá do estetiky Dash.

K dispozícii sú tiež podvádzať listy k dispozícii na stiahnutie v Dash. Tieto sa nezameriavajú na jazykové funkcie, ale skôr na pokročilé funkcie Git, Zamestnanec obľúbený textový editor Sublime Text 2 Vyskúšajte Sublime Text 2 pre potreby editácie kódu naprieč platformamiSublime Text 2 je editor viacerých platforiem pre rôzne platformy, o ktorom som sa len nedávno dozvedel, a musím povedať, že na značku beta som skutočne ohromený. Môžete si stiahnuť celú aplikáciu bez zaplatenia centu ... Čítaj viac a 3 a ďalšie populárne softvérové ​​balíky.

Cheaty sú k dispozícii aj pre funkcie HTTP, HTML a CSS Named Colors.

prístupnosť

Poznám veľa vývojárov, ktorí sa snažia čítať čierny text na bielom pozadí. Niektorí dokonca nosia špeciálne tónované okuliare, aby im uľahčili čítanie. Niektorí jednoducho potrebujú zväčšiť text.

V Dash som nenašiel žiadne konkrétne nastavenia prístupnosti ani nenašiel žiadny spôsob, ako zväčšiť veľkosť textu. Pre niektorých zrakovo postihnutých používateľov by to mohlo byť prerušenie obchodov. OS X sa však dodáva s niektorými funkciami dostupnosti (Predvoľby systému> Systém> Prístupnosť), vďaka čomu bude Dash trochu použiteľnejší.

záver

Mali by ste získať platenú verziu Dash? To záleží. V skutočnosti neexistujú žiadne presvedčivé funkcie, ktoré by spôsobili, že aktualizácia stojí za náklady. Projekt však budete podporovať tým, že sa doň zapojíte.

Bezplatnú verziu Dash používam takmer denne. Ak ste popruh kód pre bývanie a vlastní Mac, musíte túto aplikáciu. Nie je to dokonalé, ale robí svoju prácu.

Stiahnuť ▼:Pomlčka pre Mac OS X (zadarmo, 19,99 dolárov v plnej verzii)

Co si myslis? Stiahnite si ho a dajte nám vedieť svoje myšlienky v komentároch nižšie.

Fotografický kredit: Kód (Michael Himbeault)