Sådan skriver du om programmeringssprog uden en teknisk baggrund

Introduktion

Skrivning har altid været en af mine passioner. Da jeg fik et job som Web3-skribent for en ed-tech-virksomhed, var jeg i den syvende himmel. Ifølge Social Media Today læser 77% af internetbrugerne blogs. Så mit job var en mulighed for at introducere verden for mit arbejde.

Mens jeg dagdrømte om, hvordan jeg ville få et loyalt publikum og en international læserskare i løbet af de næste par måneder, blev jeg bedt af min chef om at skrive vejledninger i forskellige programmeringssprog, som er meget udbredte i Web3-verdenen. Da jeg kommer fra en ikke-teknisk baggrund, føltes det som en vanskelig opgave.

Men efter mange forsøg og fejl nåede jeg til sidst et punkt, hvor jeg havde kurateret en opskrift på at skrive lange vejledninger om forskellige programmeringssprog, og det også på en måde, som en person med en teknisk baggrund ville skrive.

Så i denne blog vil jeg dele fem tips, der sparede mig for energi og tid og hjalp mig med at skrive tekniske og faktuelt korrekte guides, der kan rangere på Google.

(Billede af Metaschool)

Hvorfor skal man skrive guides om tekniske emner?

Før denne guide springer til formlen, så lad os først forstå, hvorfor det er vigtigt at skrive guides om tekniske emner, og hvorfor det kan give gode resultater for din blog.

Først og fremmest er tekniske vejledninger en god måde for dig at komme i kontakt med et publikum og dele din viden og dine færdigheder. Men teknisk indhold er også meget nichespecifikt. Det er ikke sandsynligt, at du vil skrive sådanne guides, hvis du ejer en livsstilsblog. Men i takt med at nye teknologiske fremskridt som AI og blockchain vinder indpas, ser man en stigning i antallet af teknologirelaterede blogs. Mange har deres egne AI-støttede produkter. Det er her, teknisk skrivning kan spille en stor rolle i at drive trafik mod din blog og dit produkt.

For det andet er der ingen tvivl om, at når man i dag vil lære noget teknisk, er YouTube det sted, man skal gå hen. Der er hundredtusindvis af videoer og tutorials tilgængelige. Pladsen er ret mættet, hvis du vil. Nu tænker du måske, at hvis det nødvendige materiale allerede er tilgængeligt på YouTube, hvorfor skulle nogen så ønske at skrive lange vejledninger? Tja, det er svaret lige der. Alle omkring dig tænker mere eller mindre på samme måde. Folk fokuserer på at lave mere og mere videoindhold og er ikke klar over, at de også kan opbygge et publikum ved at skrive indhold.

For det tredje, hvis vi taler om programmeringssprog, så er der ikke mange skriftlige vejledninger på internettet. Den dokumentation, der er tilgængelig på de officielle hjemmesider, er ofte ordrig og indeholder en masse information. Guider konsoliderer i bund og grund alle de tilgængelige oplysninger fra et sprogs lange dokumentation, opsummerer dem og deler en mindre rodet, letnavigeret version for at imødekomme det publikum, der foretrækker at læse.

Til sidst vil jeg gentage, at hvis du har en virksomhed, der drejer sig om teknologi, Web3 og AI, er det at skrive guides den hurtigste måde at hjælpe dig med at rangere på forskellige søgeord og bringe din virksomhed i forgrunden. Dette er nogle af grundene til, at du bør overveje at skrive guides om tekniske emner, hvis du har en blog eller virksomhed i en lignende niche.

Tip #1 - Vælg med omhu de sprog, du vil skrive dine guides på

Det første skridt er at træde varsomt, for du ønsker ikke at skrive en guide om et sprog, som Solidity, der allerede er svært at rangere på. Derfor bør du begynde med en grundig søgeordsanalyse, før du begynder at skrive guides om et sprog. Den magiske formel for søgeord med lav indsats er: høj søgevolumen og lav sværhedsgrad. Du kan bruge Ranktracker's Keyword Finder til at gøre det. Du kan også tjekke antallet af guides i fuld længde, der allerede er blevet udgivet, for at få en idé om dine konkurrenter. For at måle dine konkurrenter kan du faktisk bruge Ranktrackers SERP Checker, som hjælper dig med at konsolidere dine konkurrenters svage punkter.

Men før du har valgt dine primære og sekundære søgeord, skal du sikre dig, at det sprog, du skriver om, ikke er ved at blive forældet eller undergår større ændringer. Nogle gange ender du måske med at finde det perfekte søgeord til at skrive din sprogguide på for så at opdage, at sprogets navn har ændret sig, f.eks. at Cairo nu er Cairo 1.0. Værktøjer som Ahrefs vil ikke vise dig det med det samme.

Hvis et sprog allerede har gennemgået en ændring, vil du se den. Men i nogle tilfælde kan et sprog stadig være i gang med at foreslå ændringer. Derfor er det også supervigtigt at lave omfattende hjemmearbejde om, hvad et sprog har tænkt sig at gøre næste gang.

Tip #2 - Vær meget specifik med hensyn til guideoversigten

Dispositionen er altafgørende, når man skriver lange vejledninger om sprog. Men at lave dispositioner er også en af de sværeste opgaver. Når du skriver guides til et bredere publikum, er der en tommelfingerregel, du skal følge: Du kan ikke være for grundlæggende, og du kan heller ikke være for teknisk. Du skal altid finde en balance mellem begge dele.

Det betyder, at både en nybegynder og en ekspert skal kunne forstå og fatte den pointe, du kommer med. Og din disposition hjælper dig meget i dette tilfælde. Her er det lige så vigtigt at opfylde søgerens hensigt og producere indholdet i overensstemmelse hermed.

Det er min erfaring, at når folk søger efter guides om sprog, leder de som regel efter praktisk viden. Derfor bør din oversigt være mere fokuseret på praktisk læring og mindre på generisk viden som f.eks. et programmeringssprogs historie.

(Billede taget fra Sulekha)

Tip #3 - Start guiden med mindre komplekse ting

Når du endelig begynder at skrive din sprogguide, skal du sørge for at starte med de grundlæggende ting og derefter øge kompleksiteten, efterhånden som du bevæger dig. Hvis du skriver om et sprog som Python, så introducer det kort og præcist fra begyndelsen. Skriv alle de vigtige og sjove fakta om sproget ned, og begynd at drysse dem ud i begyndelsen. For at fange læseren til bloggen anbefales det at tilføje statistik som f.eks. hvor mange procent af befolkningen, der bruger dette sprog osv. Du kan også tænke på det som et svar på _hvem, hvornår, _og _hvorfor _et sprog.

Derefter skal du nævne nogle af de populære projekter, der er blevet kodet ved hjælp af netop dette programmeringssprog. I mange tilfælde er folk ikke klar over, at en applikation, som de har brugt dagligt, er helt eller delvist kodet i et bestemt programmeringssprog. Det gør dem interesserede og nysgerrige, og de bliver ved med at læse. Faktisk gør det guiden mere spiselig for mindre erfarne programmører at nævne disse sjove fakta lejlighedsvis i guiden.

Du kan også overveje at lave en sammenligning mellem hovedsproget og dets konkurrent. Det vil give læseren et nyt perspektiv. Alt i alt skal du prøve at bruge de første 500-600 ord på at introducere sproget. Men prøv ikke at gå ud over denne grænse.

Tip #4 - Sæt rigeligt fokus på den kødfulde del af guiden

Som nævnt er folk, der leder efter skriftlige vejledninger på nettet, på udkig efter praktiske tips og detaljer om sproget. Du vil også se et mønster, når du læser dokumentationen til et programmeringssprog. Nogle ting er konstante på tværs af dem alle. Det gælder bl.a. datatyper, variabeltyper, frameworks, biblioteker, værktøjer osv.

Det viser, at man ikke kan gå på kompromis med disse detaljer, og at de altid bør nævnes. Selvom hvert programmeringssprog har en række forskellige frameworks, biblioteker og værktøjer, bør du vælge tre populære elementer for hvert sprog og tilføje dem. Sprogenes officielle GitHub-konti kan hjælpe dig betydeligt i denne henseende.

Nu tænker du måske, at hvis disse oplysninger allerede findes på GitHub, hvorfor skal du så tilføje dem til din guide? Information på GitHub kan være svær at navigere i, fordi der er hundredvis af filer. Derfor vil det være en stor hjælp at fokusere på de vigtige ting, da du vil udfylde et hul ved hurtigt at give læserne de tre bedste biblioteker, frameworks, værktøjer osv. Desuden vil læserne også være i stand til at få mest muligt ud af guiden.

Tip #5 - Dobbelt op på læringsdelen

Når du er begyndt at skrive hoveddelen af guiden, som indeholder sproglige detaljer, bør du sikre dig, at du giver læseren værdi ved at anvende det, du har skrevet, i praksis.

De fleste guides, der findes på internettet i dag, indeholder ikke kodning. Hvis du kommer fra en ikke-teknisk baggrund, vil du heller ikke være opmærksom på kodning. Men ved at nævne grundlæggende kodningstrin i artiklen, især ved hjælp af de frameworks og biblioteker og værktøjer, du har nævnt, kan du gøre din guide mere værdifuld.

Men hvordan kan du kode, hvis du ikke ved noget om det? Det er her, du kan få hjælp fra Bard eller ChatGPT eller Ranktrackers AI Article Writer til at hjælpe dig med f.eks. at kode den simpleste smart contract i 3 nemme trin. Du kan få det tjekket af en ven eller bekendt, der koder, eller poste det på et kodeforum for at sikre dig, at det, du har skrevet, er korrekt.

Det vil øge din autenticitet og autoritet som blogejer eller skribent.

Som konklusion,

Det er ikke let at skrive lange tekniske vejledninger, især ikke når man ikke har meget viden om programmeringsjargon. Der vil være forskellige udfordringer. Men når du først har skrevet dine første 2-3 guides til programmeringssprog, vil du få styr på tingene. Det fungerer som en proces. Selvom ovenstående tips måske ikke er den mest præcise formel til at skrive guides om programmeringssprog, kan de helt sikkert hjælpe dig med at justere og tilføje struktur til dine guides som en, der ikke tilhører en teknisk baggrund.