Kā rakstīt par programmēšanas valodām bez tehniskā priekšzināšanām

Ievads

Rakstīšana vienmēr ir bijusi mana kaislība. Kad es saņēmu darbu kā Web3 rakstniece izglītības tehnoloģiju uzņēmumā, es biju kā mākonī. Saskaņā ar Social Media Today datiem 77 % interneta lietotāju lasa emuārus. Tādējādi mans darbs bija iespēja iepazīstināt pasauli ar savu darbu.

Kamēr es sapņoju par to, kā tuvāko pāris mēnešu laikā man būs lojāla auditorija un starptautiska lasītāju auditorija, mans vadītājs man lūdza uzrakstīt ceļvežus par dažādām programmēšanas valodām, kas tiek plaši izmantotas Web3 telpā. Tā kā es nāku no netehniskas vides, tas šķita grūts uzdevums.

Tomēr pēc ilgiem izmēģinājumiem un kļūdām es beidzot nonācu pie tā, ka biju izveidojis recepti, kā rakstīt garus ceļvežus par dažādām programmēšanas valodām, turklāt tā, kā to rakstītu cilvēks, kas pieder pie tehniskas jomas.

Tāpēc šajā blogā es dalīšos ar pieciem padomiem, kas man palīdzēja ietaupīt enerģiju un laiku un palīdzēja uzrakstīt tehniskus un faktoloģiski pareizus ceļvežus, kas var ierindoties Google.

(Attēls - Metaschool)

Kāpēc jums vajadzētu rakstīt ceļvežus par tehniskām tēmām?

Pirms šī rokasgrāmata pāriet pie formulas, vispirms sapratīsim, kāpēc rakstīt rokasgrāmatas par tehniskām tēmām ir svarīgi un var dot labus rezultātus jūsu blogam.

Pirmkārt, tehniskie ceļveži ir lielisks veids, kā sazināties ar auditoriju, dalīties ar savām zināšanām un prasmēm. Tomēr tehniskais saturs ir arī ļoti specifisks. Maz ticams, ka jūs rakstīsiet šādus ceļvežus, ja jums pieder dzīvesstila emuārs. Tomēr, ņemot vērā to, ka jauni tehnoloģiskie sasniegumi, piemēram, mākslīgais intelekts un blokķēde, kļūst arvien populārāki, ar tehniku saistītie emuāri piedzīvo uzplaukumu. Daudziem no tiem ir savi produkti, kas balstīti uz mākslīgo intelektu. Šajā gadījumā tehniska rakstura rakstīšanai var būt liela nozīme, lai piesaistītu jūsu emuāra un produkta apmeklētāju plūsmu.

Otrkārt, nav šaubu, ka mūsdienās, kad vēlaties apgūt kaut ko tehnisku, YouTube ir vieta, kur jūs varat mācīties. Ir pieejami simtiem tūkstošu videoklipu un pamācību. Šī joma ir diezgan piesātināta, ja tā var teikt. Tagad jūs varat aizdomāties, ka, ja vajadzīgais materiāls jau ir pieejams YouTube, kāpēc kādam būtu vērts ķerties pie garu rokasgrāmatu rakstīšanas? Nu, tieši šeit ir jūsu atbilde. Ikviens ap jums vairāk vai mazāk domā tāpat. Cilvēki koncentrējas uz to, lai radītu arvien vairāk video satura, neapzinoties, ka auditoriju var veidot arī rakstot saturu.

Treškārt, ja runājam par programmēšanas valodām, tad internetā nav daudz rakstisku rokasgrāmatu. Oficiālajās tīmekļa vietnēs pieejamā dokumentācija mēdz būt gari un satur daudz informācijas. Rokasgrāmatās būtībā ir apkopota visa pieejamā informācija, kas sniegta valodas garajā dokumentācijā, tā ir apkopota un apkopota mazāk pārblīvētā, viegli pārlūkojamā versijā, lai apmierinātu auditoriju, kas dod priekšroku lasīšanai.

Visbeidzot, lai atkārtotu, ja jums ir bizness, kas griežas ap tehnoloģijām, Web3 un mākslīgo intelektu, rokasgrāmatu rakstīšana ir ātrākais veids, kā palīdzēt jums ierindoties dažādos atslēgvārdos un izvirzīt savu biznesu priekšplānā. Šie ir daži no iemesliem, kāpēc jums vajadzētu apsvērt ceļvežu rakstīšanu par tehniskām tēmām, ja jums ir emuārs vai uzņēmums līdzīgā nišā.

Padoms Nr. 1 - Pārdomāti izvēlieties valodas, kurās vēlaties rakstīt ceļvežus.

Pirmais solis ir rīkoties gudri, jo jūs nevēlaties rakstīt rokasgrāmatu par valodu, piemēram, Solidity, kas jau ir grūti ierindojama. Tāpēc, pirms sākt rakstīt rokasgrāmatas par kādu valodu, jāsāk ar rūpīgu atslēgvārdu izpēti. Maģiskā formula mazprasīgiem atslēgvārdiem ir šāda: liels meklēšanas apjoms un zema grūtības pakāpe. Šim nolūkam varat izmantot Ranktracker atslēgvārdu meklētāju. Varat arī pārbaudīt jau publicēto pilnmetrāžas ceļvežu skaitu, lai gūtu priekšstatu par saviem konkurentiem. Patiesībā, lai novērtētu savus konkurentus, varat izmantot Ranktracker SERP Checker, kas palīdzēs jums apkopot jūsu konkurentu vājās vietas.

Tomēr, pirms esat izvēlējies primāros un sekundāros atslēgvārdus, pārliecinieties, ka valoda, par kuru rakstāt, nav novecojusi vai tajā nav notikušas būtiskas izmaiņas. Dažreiz var gadīties, ka jūs atradīsiet perfektu atslēgas vārdu, par kuru rakstīt valodas ceļvedi, tikai tad, kad sapratīsiet, ka valodas nosaukums ir mainījies, t. i., Cairo tagad ir Cairo 1.0. Tādi rīki kā Ahrefs to uzreiz neuzrādīs.

Ja valodā jau ir veiktas izmaiņas, tās tiks redzamas. Taču dažos gadījumos valoda vēl var būt izmaiņu ierosināšanas stadijā. Tāpēc ir ļoti svarīgi veikt plašu mājasdarbu par to, ko valoda plāno darīt tālāk.

Padoms Nr. 2 - Ļoti konkrēti norādiet ceļveža izklāstu

Rakstot garas rokasgrāmatas par valodām, viss ir atkarīgs no plāna. Tomēr konspektu veidošana ir arī viens no sarežģītākajiem uzdevumiem. Rakstot rokasgrāmatas plašākai auditorijai, ir noteikts noteikums, kas jāievēro: nedrīkst būt pārāk vienkāršs un nedrīkst būt arī pārāk tehnisks. Jums vienmēr ir jāpanāk līdzsvars starp abiem.

Tas nozīmē, ka gan iesācējam programmētājam, gan ekspertam vajadzētu būt spējīgam saprast un izprast jūsu sniegto informāciju. Un jūsu izklāsts šajā gadījumā jums ļoti palīdz. Tagad šeit ir vienlīdz svarīgi izpildīt meklētāja nolūku un atbilstoši tam sagatavot saturu.

Mana pieredze liecina, ka cilvēki, meklējot rokasgrāmatas par valodām, parasti meklē praktiskas zināšanas. Tāpēc jūsu izklāstā vairāk uzmanības jāpievērš praktiskai apmācībai un mazāk vispārīgām zināšanām, piemēram, par programmēšanas valodas vēsturi.

(Attēls ņemts no Sulekha)

Padoms #3 - Sāciet ceļvedi ar mazāk sarežģītām lietām

Kad beidzot sāksiet rakstīt valodas ceļvedi, pārliecinieties, ka sākat ar pamata lietām un pēc tam, virzoties uz priekšu, palieliniet sarežģītības pakāpi. Ja rakstāt par tādu valodu kā Python, sākumā īsi un kodolīgi iepazīstiniet ar to. Pierakstiet visus svarīgākos un interesantākos faktus par valodu un sāciet tos izkaisīt jau sākumā. Lai piesaistītu lasītāju blogam, ieteicams pievienot statistiku, piemēram, cik procentu cilvēku izmanto šo valodu utt. Jūs varat arī domāt par to, ka atbildēsiet uz valodas _kāds, kad, _un _pamatoti _jautājumiem.

Tad jums ir jāmin daži no populārākajiem projektiem, kas ir kodēti, izmantojot šo konkrēto programmēšanas valodu. Daudzos gadījumos cilvēki nezina, ka lietojumprogramma, ko viņi izmanto ikdienā, ir daļēji vai pilnībā kodēta kādā noteiktā programmēšanas valodā. Tādējādi tas viņus intriģē un izraisa ziņkāri, un viņi turpina lasīt. Patiesībā, reizēm pieminot šos interesantos faktus rokasgrāmatā, rokasgrāmata kļūst pieņemamāka mazāk pieredzējušiem programmētājiem.

Varat arī apsvērt iespēju salīdzināt galveno valodu ar tās konkurentu. Tas lasītājam sniegs jaunu perspektīvu. Kopumā centieties pirmos 500-600 vārdus veltīt valodas ieviešanai. Taču centieties nepārsniegt šo robežu.

Padoms #4 - Pievērsiet pietiekami daudz uzmanības ceļveža gaļas daļai

Kā jau minēts, cilvēki, kuri meklē rakstiskus ceļvežus tiešsaistē, meklē praktiskus padomus un valodas specifiku. Arī lasot programmēšanas valodas dokumentāciju, jūs pamanīsiet kādu likumsakarību. Dažas lietas ir nemainīgas visās valodās. Tie ir datu tipi, mainīgo tipi, ietvari, bibliotēkas, rīki utt.

Tas liecina, ka šo specifiku nedrīkst apšaubīt, un tā vienmēr ir jānorāda. Lai gan katrai programmēšanas valodai ir vairāki dažādi ietvari, bibliotēkas un rīki, jums vajadzētu izvēlēties 3 populārus elementus katrai valodai un tos pievienot. Valodu oficiālie GitHub konti var jums būtiski palīdzēt šajā ziņā.

Tagad, ja šī informācija jau ir atrodama GitHub vietnē, kāpēc jums to vajadzētu pievienot savam ceļvedim? Informāciju GitHub parasti ir grūti orientēties, jo tur ir simtiem failu. Tādējādi koncentrēšanās uz svarīgākajiem fragmentiem ievērojami palīdzēs, jo jūs aizpildīsiet nepilnības, ātri sniedzot lasītājiem trīs labākās bibliotēkas, ietvarstruktūras, rīkus utt. Turklāt lasītāji arī varēs gūt maksimālu labumu no rokasgrāmatas.

Padoms Nr. 5 - dubultojiet mācīšanās daļu

Kad esat sācis rakstīt rokasgrāmatas galveno daļu, kas ietver valodas specifiku, jums jānodrošina, ka sniedzat vērtību lasītājam, praktiski piemērojot to, ko esat uzrakstījis.

Lielākajā daļā internetā pieejamo ceļvežu šodien nav ietverta kodēšana. Ja esat no netehniskas vides, jūs arī nezināt par kodēšanu. Tomēr, rakstā minot pamata kodēšanas soļus, jo īpaši izmantojot jūsu minētos ietvarus, bibliotēkas un rīkus, jūsu ceļvedis var kļūt vērtīgāks.

Bet kā jūs varat kodēt, ja par to neko nezināt? Šeit jums var palīdzēt Bard vai ChatGPT, vai Ranktracker AI Article Writer, kas palīdzēs jums, teiksim, kodēt vienkāršāko viedo līgumu 3 vienkāršos soļos. Jūs varat likt to pārbaudīt kādam draugam vai paziņam programmētājam vai publicēt to programmētāju forumā, lai pārliecinātos, ka tas, ko esat uzrakstījis, ir pareizi.

Tas palielinās jūsu kā emuāra īpašnieka vai rakstnieka autentiskumu un autoritāti.

Nobeigumā,

Rakstīt garus tehniskos ceļvežus nav viegls uzdevums, jo īpaši, ja jums nav daudz zināšanu par programmēšanas žargonu. Būs dažādi izaicinājumi. Tomēr, kad būsiet uzrakstījis pirmos 2-3 programmēšanas valodas rokasgrāmatas, jūs visu sapratīsiet. Tas darbojas kā process. Lai gan iepriekš minētie padomi, iespējams, nav visprecīzākā formula programmēšanas valodu ceļvežu rakstīšanai, tie noteikti var palīdzēt jums kā cilvēkam, kas nepieder pie tehniskas jomas, saskaņot un pievienot struktūru jūsu ceļvežiem.