Dash viib dokumentide kodeerimise Maci töölauale

Reklaam

Kui olete programmeerija, loodate juba suuresti dokumentatsioonile. Kriips (tasuta, täisversiooni eest tasuta 19,99 dollarit) on Maci rakendus, mis on loodud teie nõutud lugemise meeldivamaks kasutamiseks.

Enamik programmeerijaid ei tea oma eelistatud keelt seestpoolt. Veel vähem kiitlevad üksikasjalikud teadmised iga raamatukogu ja API kohta, millega nad kokku puutuvad. Programmeerijatena me Google. Küsime korstna ületäitumist. Lugesime dokumentatsiooni. Palju ja palju dokumente. Enamik inimesi loeb brauseris dokumentatsiooni, kuid see on parem viis. Kohtume Dashiga.

Kriips ja dokumenteerimine

Dash on rakendus, mis vahemällu salvestab dokumentatsiooni Internetist ja võimaldab teil sellele juurde pääseda konkreetse veebirakenduse kaudu. Selle saab alla laadida saidist arendaja veebisait. Erinevus tasuta ja tasulise vahel on minimaalne, tasuta versioon sisaldab ooteaega käivitamisel ja iga kord, kui vahetate dokumentatsioonikomplektide (dokumentide) vahel ja paneb teid seda ostma.

Kui otsustate Dashi tasulisele versioonile üle minna, saate seda vähemalt kasutada nii paljudes Mac'i arvutites kui teil on (arendajate sõnul piiramatu arv).

Daši väärtuspakkumine põhineb selle raamatukogude ja keelte arvul, mida see toetab, ja just siin see paistab.

Esindatud on peaaegu kõik keeled, API-d ja teegid, millest võite mõelda, samuti mõned neist, millest te ilmselt veel kuulnud pole. Siin on hästi esindatud nii veeb, mobiil kui ka süsteem.

Isiklikult arenen veebi jaoks nii esi- kui ka tagavarana ning siin on kõik, mida ma kasutan. Kahjuks on dokumentatsiooni kvaliteet natuke segane.

Dokumentatsiooni kvaliteet

Arendajad ei loonud ise dokumentatsiooni, seega pole see tegelikult nende süü. Nagu ma enne ütlesin, vahemälu vahemällu salvestab ainult olemasoleva dokumentatsiooni.

Probleem on selles, et mõnda keelt pole lihtsalt piisavalt dokumenteeritud - näiteks JavaScripti lihtsustatud vastumürk CoffeeScript CoffeeScript on JavaScript ilma peavaludetaMulle pole kunagi nii väga JavaScripti kirjutamine meeldinud. Alates päevast, kui ma selle esimese rea kirjutasin, olen alati pahaks pannud, et ükskõik, mida ma selles kirjutan, näib alati Jacksonina sarnane ... Loe rohkem . Nende dokumentatsioon on rohkem teemal “Kas pole nii lahe?” kuidas-juhendada, näidates näiteid töös kasutatavast keelest, ilma tegelikult selgitamata kuidas asjad toimivad.

Pealegi ei tundu CoffeeScripti puhul Dashis hea välja. See sobib palju paremini veebibrauseriga.

Sellegipoolest toimivad mõned dokumendikomplektid väga hästi, nagu näiteks Ruby puhul. See on keel, mis annab juurdepääsu Ruby On Rails veebirakenduse raamistikule 3 interaktiivset, lõbusat, tasuta viisi Ruby programmeerimiskeele õppimise alustamiseksRuby on väljendusrikas, väga kõrgel tasemel skriptikeel. Seda kasutatakse veebis peamiselt veebiarenduse raamistiku Ruby on Rails osana, aga ka eraldiseisvana. Kui teil on huvi, mida Ruby (mitte ... Loe rohkem , omab täielikult otsitavat dokumentatsiooni ja sobib kenasti Dash'i esteetika juurde.

Dashis on allalaadimiseks saadaval ka petulehti. Need ei keskendu keelefunktsioonidele, vaid pigem Giti edasijõudnutele funktsioonidele, personali lemmiktekstiredaktor Sublime Text 2 Proovige ülemist teksti 2. oma platvormidevahelise koodi redigeerimise vajaduste jaoksSublime Text 2 on platvormideülene koodiredaktor, millest kuulsin alles hiljuti ja pean ütlema, et olen beeta-sildist hoolimata tõeliselt muljet avaldanud. Rakenduse saate alla laadida ilma senti maksmata ... Loe rohkem ja 3 ning muud populaarsed tarkvarapaketid.

Pettuste lehed on saadaval ka HTTP funktsioonide, HTML-i ja CSS-i nimeliste värvide jaoks.

Juurdepääsetavus

Ma tean paljusid arendajaid, kes näevad vaeva musta teksti lugemiseks valge taustal. Mõni kannab isegi spetsiaalselt toonitud prille, et neil oleks kergem lugeda. Mõni peab lihtsalt teksti suurendama.

Ma ei ole Dashist ühtegi konkreetset hõlbustusseadet leidnud ega ka teksti suurendamise viisi. See võib mõne nägemispuudega kasutaja jaoks olla tehingupüüdur. Kuid OS X-l on mõned hõlbustusfunktsioonid (Süsteemi eelistused> Süsteem> Juurdepääsetavus), mis võib muuta Dashi selle natuke paremini kasutatavaks.

Järeldus

Kas peaksite saama Dash'i tasulise versiooni? See oleneb. Tegelikult pole ühtegi veenvat funktsiooni, mis muudaks versiooniuuenduse kulutasuvaks, kuid toetate projekti sisselogimisega.

Kasutan Dashi tasuta versiooni peaaegu iga päev. Kui kasutate elamiseks vajalikku koodi ja omate Maci, vajate seda rakendust. See ei ole täiuslik, kuid saab töö tehtud.

Lae alla:Kriips Mac OS X jaoks (tasuta, täisversiooni jaoks 19,99 dollarit)

Mida sa arvad? Laadige see alla ja andke meile oma mõtetest kommentaarides teada allpool.

Foto krediit: Kood (Michael Himbeault)