Dash přináší kódování dokumentace na plochu Mac

reklama

Pokud jste programátor, už se na dokumentaci velmi spoléháte. Pomlčka (zdarma, 19,99 USD za plnou verzi) je aplikace pro Mac, která má zajistit, aby vaše čtení bylo příjemnější.

Většina programátorů nezná preferovaný jazyk volby naruby. Ještě méně se může pochlubit podrobnými znalostmi každé knihovny a API, se kterými přicházejí do styku. Jako programátoři jsme Google. Žádáme Stack Overflow. Čteme dokumentaci. Spousta a spousta dokumentace. Většina lidí čte dokumentaci v prohlížeči, ale existuje lepší způsob. Seznamte se s Dashem.

Pomlčka a dokumentace

Dash je aplikace, která lokálně ukládá dokumentaci z Internetu a umožňuje vám k ní přistupovat prostřednictvím konkrétní webové aplikace. Lze jej stáhnout z internetu webové stránky pro vývojáře. Rozdíl mezi bezplatnou a placenou je minimální, bezplatná verze přichází s čekací dobou při spuštění a kdykoli přepínáte mezi sadou dokumentace (docsets) a bude vás chtít koupit.

Pokud se rozhodnete upgradovat na placenou verzi Dash, můžete ji použít alespoň na tolika počítačích Mac, kolik vlastníte (podle vývojářů neomezený počet).

Cenová nabídka společnosti Dash je založena na počtu knihoven a jazyků, které podporuje, a právě zde svítí.

Téměř každý jazyk, API a knihovna, na které si vzpomenete, je zastoupen, stejně jako některé, které jste pravděpodobně ještě neslyšeli. Zde jsou dobře zastoupeny jak web, mobil, tak systém.

Osobně se pro web vyvíjím v přední i zadní kapacitě a vše, co používám, je zde přítomno. Kvalita dokumentace je bohužel trochu smíšená taška.

Kvalita dokumentace

Vývojáři sami nevytvořili dokumentaci, takže to vlastně není jejich chyba. Jak jsem již řekl, Dash ukládá pouze existující dokumentaci.

Problém je v tom, že některé jazyky nejsou zdokumentovány - například zjednodušený JavaScript antidotum CoffeeScript CoffeeScript je JavaScript bez bolesti hlavyNikdy jsem moc rád psal JavaScript tolik. Od chvíle, kdy jsem použil svůj první řádek, jsem vždycky nesnášel, že to, co v něm píšu, vždy vypadá jako Jackson ... Přečtěte si více . Jejich dokumentace je spíše „Není to v pohodě?“ průvodce jak ukázat příklady jazyka v akci, aniž by to vlastně vysvětlil jak věci fungují.

Navíc v případě CoffeeScript nevypadá dobře v Dash. Je mnohem vhodnější pro webový prohlížeč.

Díky tomu některé sady dokumentace fungují velmi dobře, jako například sady pro Ruby. Tohle je jazyk, který pohání rámec webové aplikace Ruby On Rails 3 interaktivní, zábavné a bezplatné způsoby, jak začít učit programovací jazyk RubyRuby je výrazný skriptovací jazyk na vysoké úrovni. Používá se na webu hlavně jako součást rámce pro vývoj webových aplikací Ruby on Rails, ale také jako samostatný. Pokud vás zajímá, co Ruby (ne ... Přečtěte si více , má plně prohledávatelnou dokumentaci a pěkně zapadá do estetiky Dash.

Tam jsou také podvádět listy k dispozici ke stažení v Dash. Ty se nezaměřují na jazykové funkce, ale spíše na pokročilé funkce Gitu, Zaměstnanec oblíbený textový editor Sublime Text 2 Vyzkoušejte Sublime Text 2 pro potřeby úpravy kódu napříč platformamiSublime Text 2 je editor napříč platformami, o kterém jsem slyšel teprve nedávno, a musím říci, že na značku beta jsem opravdu ohromen. Můžete si stáhnout plnou aplikaci bez placení penny ... Přečtěte si více a 3 a další populární softwarové balíčky.

Kódy jsou také k dispozici pro HTTP funkce, HTML a CSS pojmenované barvy.

Přístupnost

Znám spoustu vývojářů, kteří se snaží číst černý text na bílém pozadí. Někteří dokonce nosí speciálně zabarvené brýle, aby jim usnadnili čtení. Někteří prostě potřebují zvětšit text.

Ve službě Dash jsem nenašel žádná konkrétní nastavení usnadnění přístupu ani nenašel žádný způsob, jak zvětšit velikost textu. Pro některé zrakově postižené uživatele by to mohlo být řešení. OS X však obsahuje některé funkce usnadnění přístupu (Předvolby systému> Systém> Usnadnění), díky čemuž by mohl být Dash trochu použitelnější.

Závěr

Měli byste získat placenou verzi Dash? To záleží. Ve skutečnosti neexistují žádné přesvědčivé funkce, díky nimž by aktualizace stála za náklady, ale projekt podporujete tím, že se do něj vložíte.

Bezplatnou verzi Dash používám téměř denně. Pokud zavěsíte kód pro bydlení a vlastníte Mac, potřebujete tuto aplikaci. Není to dokonalé, ale práce je dokončena.

Stažení:Pomlčka pro Mac OS X (zdarma, 19,99 $ pro plnou verzi)

Co myslíš? Stáhněte si jej a dejte nám vědět své myšlenky v komentářích níže.

Fotografický kredit: Kód (Michael Himbeault)