Cum să scrii despre limbaje de programare fără a avea o pregătire tehnică

Introducere

Scrisul a fost întotdeauna o pasiune a mea. Când am primit un loc de muncă ca redactor Web3 pentru o companie de tehnologie educațională, am fost în al nouălea cer. Conform Social Media Today, 77% dintre utilizatorii de internet citesc bloguri. Astfel, slujba mea a reprezentat o oportunitate de a prezenta lumii munca mea.

În timp ce visam cu ochii deschiși la cum voi avea o audiență loială și un public internațional în următoarele câteva luni, managerul meu mi-a cerut să scriu ghiduri despre diferite limbaje de programare care sunt foarte folosite în spațiul Web3. Venind dintr-un mediu non-tehnic, mi s-a părut o sarcină dificilă.

Cu toate acestea, după multe încercări și erori, am ajuns în cele din urmă la un punct în care mi-am creat o rețetă pentru a scrie ghiduri lungi despre diverse limbaje de programare, și asta într-un mod în care o persoană cu pregătire tehnică ar scrie.

Așadar, în acest blog, voi împărtăși cinci sfaturi care mi-au salvat energia și timpul și m-au ajutat să scriu ghiduri tehnice și corecte din punct de vedere factual care pot fi clasate pe Google.

(Imagine de Metaschool)

De ce ar trebui să scrieți ghiduri pe teme tehnice?

Înainte ca acest ghid să treacă la formulă, să înțelegem mai întâi de ce scrierea de ghiduri pe teme tehnice este importantă și poate da rezultate bune pentru blogul tău.

În primul rând, ghidurile tehnice reprezintă o modalitate excelentă de a vă conecta cu un public, de a vă împărtăși cunoștințele și abilitățile. Cu toate acestea, conținutul tehnic este, de asemenea, foarte specific unei nișe. Este puțin probabil să scrieți astfel de ghiduri dacă dețineți un blog de lifestyle. Cu toate acestea, odată cu noile progrese tehnologice, cum ar fi AI și blockchain, care câștigă teren, blogurile legate de tehnologie cunosc o creștere. Multe dintre ele au propriile produse susținute de AI. Acesta este locul în care scrierea tehnică poate juca un rol imens în atragerea traficului către blogul și produsul dvs.

În al doilea rând, nu există nicio îndoială că, în ziua de azi, atunci când vrei să înveți ceva tehnic, YouTube este locul unde trebuie să te duci. Există sute de mii de videoclipuri și tutoriale disponibile. Spațiul este destul de saturat, dacă vreți. Poate vă întrebați acum că, dacă materialul necesar este deja disponibil pe YouTube, de ce ar vrea cineva să recurgă la scrierea unor ghiduri lungi? Ei bine, acesta este răspunsul tău chiar acolo. Toată lumea din jurul tău gândește, mai mult sau mai puțin, la fel. Oamenii se concentrează pe realizarea a tot mai mult conținut video, fără să realizeze că își pot construi o audiență și prin scrierea de conținut.

În al treilea rând, dacă vorbim despre limbaje de programare, atunci nu există prea multe ghiduri scrise pe internet. Documentația disponibilă pe site-urile oficiale tinde să fie stufoasă și să conțină multe informații. În esență, ghidurile consolidează toate informațiile disponibile furnizate de documentația lungă a unui limbaj, le rezumă și împărtășesc o versiune mai puțin aglomerată și ușor de navigat pentru a se adresa publicului care preferă să citească.

În cele din urmă, pentru a reitera, dacă aveți o afacere care se învârte în jurul tehnologiei, Web3 și AI, scrierea de ghiduri este cel mai rapid mod de a vă ajuta să vă poziționați pentru diferite cuvinte cheie și să vă aduceți afacerea în prim-plan. Acestea sunt câteva dintre motivele pentru care ar trebui să luați în considerare scrierea de ghiduri pe teme tehnice dacă aveți un blog sau o afacere într-o nișă similară.

Sfat #1 - Alegeți cu înțelepciune limbile în care doriți să vă scrieți ghidurile

Primul pas este să acționați cu înțelepciune, deoarece nu ați dori să scrieți un ghid despre un limbaj, cum ar fi Solidity, care este deja dificil de clasificat. Astfel, ar trebui să începeți cu o cercetare amănunțită a cuvintelor cheie înainte de a începe să scrieți ghiduri despre un limbaj. Formula magică pentru cuvintele cheie cu efort redus este; volum mare de căutare și dificultate scăzută. Pentru aceasta, puteți profita de instrumentul Ranktracker's Keyword Finder. De asemenea, puteți verifica numărul de ghiduri complete care au fost deja publicate pentru a vă face o idee despre concurenții dumneavoastră. De fapt, pentru a vă evalua concurenții, puteți utiliza Ranktracker's SERP Checker, care vă va ajuta să consolidați punctele slabe ale concurenților dumneavoastră.

Cu toate acestea, înainte de a vă selecta cuvintele-cheie principale și secundare, asigurați-vă că limba în care scrieți nu devine învechită sau nu suferă schimbări majore. Uneori s-ar putea să ajungeți să găsiți cuvântul cheie perfect pentru a scrie ghidul lingvistic, doar pentru a realiza că numele limbii s-a schimbat, de exemplu, Cairo este acum Cairo 1.0. Instrumente precum Ahrefs nu vă vor arăta instantaneu acest lucru.

Dacă o limbă a suferit deja o modificare, veți vedea acest lucru. Dar, în unele cazuri, este posibil ca o limbă să se afle încă în stadiul de a propune modificări. Acesta este motivul pentru care este de asemenea super important să vă faceți teme extinse cu privire la ceea ce intenționează să facă o limbă în continuare.

Sfat nr. 2 - Fiți foarte specific cu privire la schița ghidului

Schița este esențială atunci când se scriu ghiduri lungi despre limbi străine. Cu toate acestea, crearea de schițe se întâmplă să fie, de asemenea, una dintre sarcinile dificile. Atunci când scrieți ghiduri pentru un public mai larg, există o regulă de bază pe care trebuie să o urmați: nu puteți fi prea elementar și nici prea tehnic. Trebuie să găsiți întotdeauna un echilibru între cele două.

Acest lucru înseamnă că atât un programator începător, cât și un expert ar trebui să fie capabil să înțeleagă și să sesizeze punctul pe care îl susțineți. Iar schița dvs. vă ajută foarte mult în acest caz. Acum, aici este la fel de important să răspundeți intenției căutătorului și să produceți conținutul în consecință.

Din experiența mea, atunci când oamenii caută ghiduri despre limbi străine, caută de obicei cunoștințe practice. Astfel, schița dvs. ar trebui să se concentreze mai mult pe învățarea practică și mai puțin pe cunoștințe generice, cum ar fi istoria unui limbaj de programare.

(Imagine preluată din Sulekha)

Sfat #3 - Începeți ghidul cu lucruri mai puțin complexe

Când începeți în sfârșit să vă scrieți ghidul lingvistic, asigurați-vă că începeți cu lucrurile de bază și apoi creșteți complexitatea pe măsură ce avansați. Dacă scrieți despre un limbaj precum Python, prezentați-l pe scurt și succint încă de la început. Notați toate faptele importante și amuzante despre limbaj și începeți să le presărați la început. Pentru a agăța cititorul de blog, este recomandat să adăugați statistici, cum ar fi ce procentaj de oameni folosesc acest limbaj etc. De asemenea, vă puteți gândi la aceasta ca la un răspuns la întrebările _cine, când și de ce_ ale unei limbi.

Apoi, trebuie să menționați câteva dintre proiectele populare care au fost codate folosind acest limbaj de programare. În multe cazuri, oamenii nu sunt conștienți că o aplicație pe care au folosit-o zilnic este parțial sau integral codată într-un anumit limbaj de programare. Astfel, acest lucru îi face să fie intrigați și curioși și continuă să citească. De fapt, menționarea ocazională a acestor fapte amuzante în cadrul ghidului face ca acesta să fie mai acceptabil pentru programatorii mai puțin experimentați.

Puteți, de asemenea, să vă gândiți să faceți o comparație între limba principală și limba concurentă. Acest lucru va aduce în continuare o nouă perspectivă cititorului. În concluzie, încercați să folosiți primele 500-600 de cuvinte pentru a prezenta limba. Încercați însă să nu depășiți această limită.

Sfat #4 - Puneți accent pe partea de carne a ghidului

După cum am menționat, persoanele care caută ghiduri scrise online caută sfaturi practice și specificul limbii. Veți observa, de asemenea, un model atunci când citiți documentația unui limbaj de programare. Unele lucruri sunt constante în toate. Printre acestea se numără tipurile de date, tipurile de variabile, cadrele, bibliotecile, instrumentele etc.

Acest lucru arată că nu se poate face niciun compromis cu privire la aceste detalii și că acestea trebuie menționate întotdeauna. În timp ce fiecare limbaj de programare are o serie de cadre, biblioteci și instrumente diferite, ceea ce ar trebui să faceți este să alegeți 3 elemente populare pentru fiecare și să le adăugați. Conturile GitHub oficiale ale limbajelor vă pot ajuta semnificativ în această privință.

Poate vă întrebați că dacă aceste detalii sunt deja acolo pe GitHub, de ce ar trebui să le adăugați la ghidul dumneavoastră? Ei bine, informațiile de pe GitHub tind să fie dificil de navigat, deoarece există sute de fișiere. Astfel, concentrarea pe fragmentele importante va fi de mare ajutor, deoarece veți umple un gol, oferind rapid cititorilor cele mai importante 3 biblioteci, cadre, instrumente etc. În plus, cititorii vor putea, de asemenea, să profite la maximum de ghid.

Sfat #5 - Dublați partea de învățare

După ce ați început să scrieți partea principală a ghidului, care include specificul limbii, trebuie să vă asigurați că oferiți valoare cititorului prin aplicarea practică a ceea ce ați scris.

Cele mai multe ghiduri disponibile astăzi pe internet nu includ codarea. Dacă proveniți dintr-un mediu non-tehnic, nu veți fi, de asemenea, conștient de codificare. Cu toate acestea, menționarea pașilor de codare de bază în cadrul articolului, în special prin utilizarea cadrelor și bibliotecilor și a instrumentelor pe care le-ați menționat, poate face ca ghidul dvs. să aibă mai multă valoare.

Dar cum poți codifica dacă nu știi nimic despre asta? Aici puteți primi ajutor de la Bard sau ChatGPT sau de la scriitorul de articole AI al Ranktracker pentru a vă ajuta, să zicem, să codificați cel mai simplu contract inteligent, în 3 pași simpli. Îl puteți face să fie verificat de un prieten sau o cunoștință coder sau îl puteți posta pe un forum de coderi pentru a vă asigura că ceea ce ați scris este corect.

Acest lucru va contribui la autenticitatea și autoritatea dumneavoastră ca proprietar de blog sau scriitor.

În concluzie,

Scrierea unor ghiduri tehnice lungi nu este o sarcină ușoară, mai ales atunci când nu ai prea multe cunoștințe despre jargonul de programare. Vor exista diverse provocări. Cu toate acestea, odată ce ați scris primele 2-3 ghiduri despre limbajele de programare, vă veți obișnui cu lucrurile. Funcționează ca un proces. În timp ce sfaturile menționate mai sus s-ar putea să nu fie cea mai precisă formulă pentru scrierea de ghiduri despre limbaje de programare, ele vă pot ajuta cu siguranță să vă aliniați și să adăugați structură ghidurilor dumneavoastră ca persoană care nu aparține unui mediu tehnic.