Το Dash φέρνει τεκμηρίωση κωδικοποίησης στην επιφάνεια εργασίας Mac

Διαφήμιση

Εάν είστε προγραμματιστής, βασίζεστε ήδη πολύ στην τεκμηρίωση. Παύλα (δωρεάν, 19,99 $ για πλήρη έκδοση) είναι μια εφαρμογή Mac που έχει σχεδιαστεί για να κάνει την απαιτούμενη ανάγνωση πιο ευχάριστη εμπειρία.

Οι περισσότεροι προγραμματιστές δεν γνωρίζουν την προτιμώμενη γλώσσα επιλογής τους από μέσα προς τα έξω. Ακόμη λιγότεροι διαθέτουν λεπτομερείς γνώσεις για κάθε βιβλιοθήκη και API με το οποίο έρχονται σε επαφή. Ως προγραμματιστές είμαστε Google. Ζητάμε Stack Overflow. Διαβάζουμε τεκμηρίωση. Πολλή τεκμηρίωση. Τα περισσότερα άτομα διαβάζουν τεκμηρίωση σε ένα πρόγραμμα περιήγησης, αλλά υπάρχει ένας καλύτερος τρόπος. Γνωρίστε τον Dash.

Dash και τεκμηρίωση

Το Dash είναι μια εφαρμογή που αποθηκεύει προσωρινά την τεκμηρίωση από το Διαδίκτυο και σας επιτρέπει να έχετε πρόσβαση σε αυτήν μέσω μιας συγκεκριμένης εφαρμογής ιστού. Μπορείτε να το κατεβάσετε από το ιστότοπος προγραμματιστή. Η διαφορά μεταξύ δωρεάν και επί πληρωμή είναι ελάχιστη, η δωρεάν έκδοση συνοδεύεται από χρόνο αναμονής κατά την εκκίνηση και όποτε αλλάζετε μεταξύ συνόλων τεκμηρίωσης (docsets) και θα σας ενοχλεί για να το αγοράσετε.

Εάν επιλέξετε να πραγματοποιήσετε αναβάθμιση στην πληρωμένη έκδοση του Dash, μπορείτε τουλάχιστον να το χρησιμοποιήσετε σε όσους υπολογιστές Mac διαθέτετε (απεριόριστος αριθμός, σύμφωνα με τους προγραμματιστές).

Η πρόταση αξίας του Dash βασίζεται στον αριθμό των βιβλιοθηκών και των γλωσσών που υποστηρίζει και εδώ λάμπει.

Αντιπροσωπεύεται σχεδόν κάθε γλώσσα, API και βιβλιοθήκη που μπορείτε να σκεφτείτε, καθώς και ορισμένες που πιθανώς δεν έχετε ακούσει. Τόσο ο Ιστός, το κινητό όσο και το σύστημα παρουσιάζονται εδώ

Προσωπικά, αναπτύσσομαι για το διαδίκτυο με χωρητικότητα front and back-end, και ό, τι χρησιμοποιώ είναι παρόν εδώ. Δυστυχώς, η ποιότητα της τεκμηρίωσης είναι λίγο μικτή τσάντα.

Η ποιότητα της τεκμηρίωσης

Οι προγραμματιστές δεν δημιούργησαν την τεκμηρίωση οι ίδιοι, επομένως δεν είναι δικό τους λάθος. Όπως είπα προηγουμένως, το Dash αποθηκεύει προσωρινά μόνο προϋπάρχουσα τεκμηρίωση.

Το πρόβλημα είναι ότι ορισμένες γλώσσες δεν είναι καλά τεκμηριωμένες - όπως το απλοποιημένο αντίδοτο JavaScript CoffeeScript Το CoffeeScript είναι JavaScript χωρίς τους πονοκεφάλουςΠοτέ δεν μου άρεσε πολύ να γράφω JavaScript. Από την ημέρα που έγραψα την πρώτη μου γραμμή χρησιμοποιώντας το, πάντα μου άρεσε ότι ό, τι γράφω σε αυτό καταλήγει πάντα να μοιάζει με Τζάκσον ... Διαβάστε περισσότερα . Η τεκμηρίωσή τους είναι περισσότερο "Δεν είναι τόσο ωραίο;" πώς να καθοδηγήσετε, δείχνοντας παραδείγματα της γλώσσας σε δράση, χωρίς να το εξηγήσετε πως τα πράγματα λειτουργούν.

Επιπλέον, στην περίπτωση του CoffeeScript, δεν φαίνεται καλό στο Dash. Είναι πολύ πιο κατάλληλο για ένα πρόγραμμα περιήγησης ιστού.

Με αυτά, ορισμένα σετ τεκμηρίωσης λειτουργούν πολύ καλά, όπως αυτά του Ruby. Αυτό είναι τη γλώσσα που υποστηρίζει το πλαίσιο εφαρμογής διαδικτύου Ruby On Rails 3 Διαδραστικοί, διασκεδαστικοί, δωρεάν τρόποι για να ξεκινήσετε να μαθαίνετε τη γλώσσα προγραμματισμού RubyΤο Ruby είναι μια εκφραστική, πολύ υψηλού επιπέδου γλώσσα γραφής. Χρησιμοποιείται στον Ιστό κυρίως ως μέρος του πλαισίου ανάπτυξης ιστοσελίδων Ruby on Rails, αλλά και αυτόνομο. Αν είστε περίεργοι για το τι Ruby (όχι ... Διαβάστε περισσότερα , έχει πλήρη τεκμηρίωση με δυνατότητα αναζήτησης και ταιριάζει όμορφα στην αισθητική Dash.

Υπάρχουν επίσης φύλλα cheat διαθέσιμα για λήψη στο Dash. Αυτά δεν επικεντρώνονται στις λειτουργίες γλώσσας, αλλά στις προηγμένες δυνατότητες του Git, αγαπημένο πρόγραμμα επεξεργασίας κειμένου Sublime Text 2 Δοκιμάστε το Sublime Text 2 για τις ανάγκες επεξεργασίας κώδικα μεταξύ πλατφορμώνΤο Sublime Text 2 είναι ένας επεξεργαστής κώδικα πολλαπλών πλατφορμών που μόλις άκουσα πρόσφατα και πρέπει να πω ότι είμαι πραγματικά εντυπωσιασμένος παρά την ετικέτα beta. Μπορείτε να κατεβάσετε την πλήρη εφαρμογή χωρίς να πληρώσετε ούτε δεκάρα ... Διαβάστε περισσότερα και 3, και άλλα δημοφιλή πακέτα λογισμικού.

Cheat φύλλα είναι επίσης διαθέσιμα για χαρακτηριστικά HTTP, HTML και CSS Named Colors.

Προσιτότητα

Γνωρίζω πολλούς προγραμματιστές που αγωνίζονται να διαβάσουν μαύρο κείμενο σε λευκό φόντο. Μερικοί φορούν ακόμη και ειδικά χρωματισμένα γυαλιά για να διευκολύνουν την ανάγνωσή τους. Μερικοί απλά πρέπει να μεγεθύνουν το κείμενο.

Δεν βρήκα συγκεκριμένες ρυθμίσεις προσβασιμότητας στο Dash, ούτε βρήκα τρόπο να αυξήσω το μέγεθος του κειμένου. Αυτό μπορεί να είναι μια λύση για ορισμένους χρήστες με προβλήματα όρασης. Ωστόσο, το OS X διαθέτει ορισμένες δυνατότητες προσβασιμότητας (Προτιμήσεις συστήματος> Σύστημα> Προσβασιμότητα) που θα μπορούσε να κάνει το Dash λίγο πιο εύχρηστο.

συμπέρασμα

Πρέπει να λάβετε την πληρωμένη έκδοση του Dash; Αυτο εξαρταται. Δεν υπάρχουν πραγματικά συναρπαστικές δυνατότητες που να κάνουν την αναβάθμιση αξίζει το κόστος, αλλά θα υποστηρίζετε το έργο κάνοντας κλικ.

Χρησιμοποιώ τη δωρεάν έκδοση του Dash σχεδόν καθημερινά. Εάν κάνετε κώδικα για τα προς το ζην και διαθέτετε Mac, χρειάζεστε αυτήν την εφαρμογή. Δεν είναι τέλειο, αλλά κάνει τη δουλειά.

Κατεβάστε:Dash για Mac OS X (δωρεάν, 19,99 $ για πλήρη έκδοση)

Τι νομίζετε; Κατεβάστε το και πείτε μας τις σκέψεις σας στα παρακάτω σχόλια.

Δικαιώματα φωτογραφίας: Κωδικός (Michael Himbeault)