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

Αν είστε προγραμματιστής, βασίζεστε ήδη σε τεκμηρίωση. Το Dash είναι μια εφαρμογή Mac που έχει σχεδιαστεί για να κάνει την απαιτούμενη ανάγνωσή σας μια πιο ευχάριστη εμπειρία.

Αν είστε προγραμματιστής, βασίζεστε ήδη σε τεκμηρίωση.  Το Dash είναι μια εφαρμογή Mac που έχει σχεδιαστεί για να κάνει την απαιτούμενη ανάγνωσή σας μια πιο ευχάριστη εμπειρία.
Διαφήμιση

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

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

Πίνακας και τεκμηρίωση

Το Dash είναι μια εφαρμογή που αποθηκεύει τοπικά την τεκμηρίωση από το Internet και σας επιτρέπει να την αποκτάτε μέσω μιας συγκεκριμένης εφαρμογής ιστού. Μπορεί να μεταφορτωθεί από τον ιστότοπο του Mac App Store ή του προγραμματιστή, ενώ ο πρώην έχει μια αγορά εντός της εφαρμογής $ 19.99. Η διαφορά μεταξύ δωρεάν και πληρωμένου είναι ελάχιστη, η δωρεάν έκδοση έρχεται με ένα χρόνο αναμονής κατά την εκκίνηση και κάθε φορά που αλλάζετε μεταξύ των συνόλων τεκμηρίωσης (docsets) και θα σας nag να το αγοράσετε.

dash-nag

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

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

dash-docsets

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

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

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

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

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

dash-καφέ

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

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

dash-rb

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

Τα απατεώνες είναι επίσης διαθέσιμα για τις λειτουργίες HTTP, HTML και CSS Named Colors.

Προσιτότητα

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

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

συμπέρασμα

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

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

Λήψη: Dash για Mac OS X (δωρεάν, $ 19.99 για πλήρη έκδοση)

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

Φωτογραφική Πίστωση: Κωδικός (Michael Himbeault)

In this article