Πώς να γράφετε για γλώσσες προγραμματισμού χωρίς τεχνικό υπόβαθρο

Εισαγωγή

Η συγγραφή ήταν πάντα ένα πάθος μου. Όταν βρήκα δουλειά ως συγγραφέας Web3 για μια εταιρεία εκπαιδευτικής τεχνολογίας, ήμουν στα σύννεφα. Σύμφωνα με το Social Media Today, το 77% των χρηστών του διαδικτύου διαβάζει ιστολόγια. Έτσι, η δουλειά μου ήταν μια ευκαιρία να γνωρίσει ο κόσμος τη δουλειά μου.

Ενώ ονειροπολούσα για το πώς θα έχω ένα πιστό κοινό και ένα διεθνές αναγνωστικό κοινό μέσα στους επόμενους δύο μήνες, μου ζητήθηκε από τον διευθυντή μου να γράψω οδηγούς για διάφορες γλώσσες προγραμματισμού που χρησιμοποιούνται ευρέως στον χώρο του Web3. Προερχόμενος από ένα μη τεχνικό υπόβαθρο, αυτό μου φάνηκε δύσκολο έργο.

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

Έτσι, σε αυτό το ιστολόγιο, θα μοιραστώ πέντε συμβουλές που εξοικονόμησαν την ενέργειά μου και τον χρόνο μου και με βοήθησαν να γράψω τεχνικά και πραγματικά σωστούς οδηγούς που μπορούν να καταταγούν στην Google.

(Εικόνα από Metaschool)

Γιατί πρέπει να γράφετε οδηγούς για τεχνικά θέματα;

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

Πρώτα απ' όλα, οι τεχνικοί οδηγοί αποτελούν έναν εξαιρετικό τρόπο για να συνδεθείτε με το κοινό, να μοιραστείτε τις γνώσεις και τις δεξιότητές σας. Ωστόσο, το τεχνικό περιεχόμενο είναι επίσης πολύ εξειδικευμένο. Δεν είναι πιθανό να γράψετε τέτοιους οδηγούς αν είστε ιδιοκτήτης ενός ιστολογίου lifestyle. Ωστόσο, με τις νέες τεχνολογικές εξελίξεις, όπως η τεχνητή νοημοσύνη και η αλυσίδα μπλοκ να κερδίζουν έδαφος, τα ιστολόγια που σχετίζονται με την τεχνολογία σημειώνουν άνοδο. Πολλά έχουν τα δικά τους προϊόντα που υποστηρίζονται από την ΤΝ. Εδώ είναι που η τεχνική συγγραφή μπορεί να παίξει τεράστιο ρόλο στην προώθηση της επισκεψιμότητας προς το ιστολόγιο και το προϊόν σας.

Δεύτερον, δεν υπάρχει καμία αμφιβολία ότι στη σημερινή εποχή, όταν θέλετε να μάθετε κάτι τεχνικό, το YouTube είναι ο τόπος που θα απευθυνθείτε. Υπάρχουν εκατοντάδες χιλιάδες διαθέσιμα βίντεο και εκπαιδευτικά προγράμματα. Ο χώρος είναι αρκετά κορεσμένος αν θέλετε. Μπορεί τώρα να αναρωτηθείτε ότι αν το απαιτούμενο υλικό είναι ήδη διαθέσιμο στο YouTube, γιατί να θέλει κάποιος να καταφύγει στη συγγραφή μακροσκελών οδηγών; Λοιπόν, αυτή είναι η απάντησή σας ακριβώς εκεί. Όλοι γύρω σας, λίγο πολύ, σκέφτονται με τον ίδιο τρόπο. Οι άνθρωποι επικεντρώνονται στη δημιουργία όλο και περισσότερου περιεχομένου βίντεο, χωρίς να συνειδητοποιούν ότι μπορούν να δημιουργήσουν κοινό και με τη συγγραφή περιεχομένου.

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

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

Συμβουλή #1 - Επιλέξτε με σύνεση τις γλώσσες στις οποίες θέλετε να γράψετε τους οδηγούς σας

Το πρώτο βήμα είναι να κινηθείτε με σύνεση, διότι δεν θα θέλατε να γράψετε έναν οδηγό για μια γλώσσα, όπως η Solidity, για την οποία είναι ήδη δύσκολο να καταταγείτε. Έτσι, θα πρέπει να ξεκινήσετε με ενδελεχή έρευνα λέξεων-κλειδιών πριν αρχίσετε να γράφετε οδηγούς για μια γλώσσα. Η μαγική φόρμουλα για λέξεις-κλειδιά χαμηλής προσπάθειας είναι: υψηλός όγκος αναζήτησης και χαμηλή δυσκολία. Μπορείτε να αξιοποιήσετε την αναζήτηση λέξεων-κλειδιών του Ranktracker για να το κάνετε αυτό. Μπορείτε επίσης να ελέγξετε τον αριθμό των οδηγών πλήρους έκτασης που έχουν ήδη δημοσιευτεί για να πάρετε μια ιδέα για τους ανταγωνιστές σας. Στην πραγματικότητα, προκειμένου να μετρήσετε τους ανταγωνιστές σας, μπορείτε να χρησιμοποιήσετε το SERP Checker του Ranktracker, το οποίο θα σας βοηθήσει να εδραιώσετε τα αδύνατα σημεία των ανταγωνιστών σας.

Ωστόσο, προτού επιλέξετε τις κύριες και δευτερεύουσες λέξεις-κλειδιά σας, βεβαιωθείτε ότι η γλώσσα στην οποία γράφετε δεν έχει ξεπεραστεί ή δεν υφίσταται σημαντικές αλλαγές. Μερικές φορές μπορεί να καταλήξετε να βρείτε την τέλεια λέξη-κλειδί για να γράψετε τον γλωσσικό σας οδηγό, μόνο και μόνο για να συνειδητοποιήσετε ότι το όνομα της γλώσσας έχει αλλάξει, π.χ. το Κάιρο είναι τώρα Κάιρο 1.0. Εργαλεία όπως το Ahrefs δεν θα σας το δείξουν αμέσως αυτό.

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

Συμβουλή #2 - Να είστε πολύ συγκεκριμένοι σχετικά με το περίγραμμα του οδηγού

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

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

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

(Η εικόνα προέρχεται από το Sulekha)

Συμβουλή #3 - Ξεκινήστε τον οδηγό με λιγότερο σύνθετα πράγματα

Όταν τελικά αρχίσετε να γράφετε τον γλωσσικό σας οδηγό, φροντίστε να ξεκινήσετε με τα βασικά πράγματα και στη συνέχεια να αυξάνετε την πολυπλοκότητα όσο προχωράτε. Αν γράφετε για μια γλώσσα όπως η Python, παρουσιάστε την με συντομία και περιεκτικότητα από την αρχή. Σημειώστε όλα τα σημαντικά και διασκεδαστικά στοιχεία σχετικά με τη γλώσσα και αρχίστε να τα πασπαλίζετε στην αρχή. Προκειμένου να αγκιστρώσετε τον αναγνώστη στο ιστολόγιο, συνιστάται να προσθέσετε στατιστικά στοιχεία όπως τι ποσοστό ανθρώπων χρησιμοποιεί αυτή τη γλώσσα κ.λπ. Μπορείτε επίσης να το θεωρήσετε ως απάντηση στο _ποιος, πότε, _και _γιατί _μιας γλώσσας.

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

Μπορείτε επίσης να εξετάσετε το ενδεχόμενο σύγκρισης μεταξύ της κύριας γλώσσας και του ανταγωνιστή της. Αυτό θα δώσει περαιτέρω μια νέα προοπτική στον αναγνώστη. Συνολικά, προσπαθήστε να αφιερώσετε τις πρώτες 500-600 λέξεις στην εισαγωγή της γλώσσας. Προσπαθήστε όμως να μην υπερβείτε αυτό το όριο.

Συμβουλή #4 - Επικεντρωθείτε επαρκώς στο σημαντικό μέρος του οδηγού

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

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

Τώρα, μπορεί να αναρωτηθείτε ότι αν αυτές οι λεπτομέρειες υπάρχουν ήδη στο GitHub, γιατί θα πρέπει να τις προσθέσετε στον οδηγό σας; Λοιπόν, οι πληροφορίες στο GitHub τείνουν να είναι δύσκολο να περιηγηθείτε επειδή υπάρχουν εκατοντάδες αρχεία. Έτσι, η εστίαση στα σημαντικά κομμάτια θα βοηθήσει σημαντικά, καθώς θα καλύψετε ένα κενό παρέχοντας γρήγορα στους αναγνώστες τις 3 κορυφαίες βιβλιοθήκες, πλαίσια, εργαλεία κ.λπ. Επιπλέον, οι αναγνώστες θα είναι επίσης σε θέση να αξιοποιήσουν στο έπακρο τον οδηγό.

Συμβουλή #5 - Διπλασιάστε το κομμάτι της μάθησης

Όταν αρχίσετε να γράφετε το κύριο μέρος του οδηγού που περιλαμβάνει γλωσσικές λεπτομέρειες, θα πρέπει να βεβαιωθείτε ότι παρέχετε αξία στον αναγνώστη εφαρμόζοντας πρακτικά αυτά που έχετε γράψει.

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

Αλλά πώς μπορείτε να κωδικοποιήσετε αν δεν γνωρίζετε τίποτα γι' αυτό; Εδώ είναι που μπορείτε να λάβετε βοήθεια από τον Bard ή το ChatGPT ή τον AI Article Writer του Ranktracker για να σας βοηθήσει, ας πούμε να κωδικοποιήσετε το απλούστερο έξυπνο συμβόλαιο, σε 3 εύκολα βήματα. Μπορείτε να το ελέγξει ένας φίλος ή γνωστός σας κωδικοποιητής ή να το δημοσιεύσετε στο φόρουμ ενός κωδικοποιητή για να βεβαιωθείτε ότι αυτά που γράψατε είναι σωστά.

Αυτό θα ενισχύσει την αυθεντικότητα και την αυθεντικότητά σας ως ιδιοκτήτης ή συγγραφέας ιστολογίου.

Εν κατακλείδι,

Η συγγραφή μακροσκελών τεχνικών οδηγών δεν είναι εύκολη υπόθεση, ειδικά όταν δεν έχετε πολλές γνώσεις σχετικά με την ορολογία του προγραμματισμού. Θα υπάρξουν διάφορες προκλήσεις. Ωστόσο, μόλις γράψετε τους πρώτους 2-3 οδηγούς σας για γλώσσες προγραμματισμού, θα πάρετε τον έλεγχο των πραγμάτων. Λειτουργεί ως διαδικασία. Αν και οι συμβουλές που αναφέρθηκαν παραπάνω μπορεί να μην είναι η πιο ακριβής φόρμουλα για τη συγγραφή οδηγών για γλώσσες προγραμματισμού, σίγουρα μπορούν να σας βοηθήσουν να ευθυγραμμιστείτε και να προσθέσετε δομή στους οδηγούς σας ως κάποιος που δεν ανήκει σε τεχνικό υπόβαθρο.