Schrijven over programmeertalen zonder technische achtergrond

Intro

Schrijven is altijd al een passie van me geweest. Toen ik een baan kreeg als Web3-schrijver voor een ed-tech bedrijf, was ik in de wolken. Volgens Social Media Today leest 77% van de internetgebruikers blogs. Mijn baan was dus een kans om de wereld kennis te laten maken met mijn werk.

Terwijl ik aan het dagdromen was over hoe ik in de komende maanden een trouw publiek en een internationaal lezerspubliek zal hebben, werd ik door mijn manager gevraagd om gidsen te schrijven over verschillende programmeertalen die veel gebruikt worden in de Web3-ruimte. Omdat ik een niet-technische achtergrond heb, voelde dit als een moeilijke taak.

Maar na veel vallen en opstaan bereikte ik uiteindelijk een punt waarop ik een recept had samengesteld voor het schrijven van lange gidsen over verschillende programmeertalen, en dat ook nog eens op een manier die iemand met een technische achtergrond zou schrijven.

In deze blog deel ik vijf tips die mij energie en tijd hebben bespaard en die mij hebben geholpen om technische en feitelijk correcte gidsen te schrijven die goed scoren in Google.

(Afbeelding door Metaschool)

Waarom zou je gidsen over technische onderwerpen schrijven?

Voordat deze gids overgaat op de formule, moeten we eerst begrijpen waarom het schrijven van gidsen over technische onderwerpen belangrijk is en goede resultaten kan opleveren voor je blog.

Ten eerste zijn technische gidsen een geweldige manier om in contact te komen met een publiek en om je kennis en vaardigheden te delen. Technische inhoud is echter ook erg nichespecifiek. Je zult waarschijnlijk niet zulke gidsen schrijven als je een lifestyleblog hebt. Maar nu nieuwe technologische ontwikkelingen zoals AI en blockchain steeds populairder worden, zien tech-gerelateerde blogs een opmars. Veel blogs hebben hun eigen AI-producten. Dit is waar technisch schrijven een grote rol kan spelen in het verkeer naar je blog en product.

Ten tweede lijdt het geen twijfel dat in de huidige tijd, wanneer je iets technisch wilt leren, YouTube de plaats is waar je moet zijn. Er zijn honderdduizenden video's en tutorials beschikbaar. De ruimte is behoorlijk verzadigd. Je vraagt je nu misschien af: als het benodigde materiaal al beschikbaar is op YouTube, waarom zou iemand dan zijn toevlucht nemen tot het schrijven van lange gidsen? Nou, dat is je antwoord. Iedereen om je heen denkt er min of meer hetzelfde over. Mensen richten zich op het maken van steeds meer videocontent en realiseren zich niet dat ze ook een publiek kunnen opbouwen door content te schrijven.

Ten derde, als we het hebben over programmeertalen, dan zijn er niet veel geschreven gidsen op het internet. De documentatie die beschikbaar is op de officiële websites is vaak langdradig en bevat veel informatie. Gidsen consolideren in wezen alle beschikbare informatie uit de lange documentatie van een taal, vatten het samen en delen een minder overzichtelijke, eenvoudig te navigeren versie om tegemoet te komen aan het publiek dat liever leest.

Tot slot, als je een bedrijf hebt dat draait om technologie, Web3 en AI, is het schrijven van gidsen de snelste manier om je te helpen rangschikken voor verschillende zoekwoorden en je bedrijf naar de voorgrond te brengen. Dit zijn enkele van de redenen waarom je zou moeten overwegen om gidsen over technische onderwerpen te schrijven als je een blog of bedrijf in een soortgelijke niche hebt.

Tip #1 - Kies verstandig de talen waarin je je gidsen wilt schrijven

De eerste stap is om verstandig te werk te gaan, omdat je geen gids wilt schrijven over een taal, zoals Solidity, die al moeilijk te vinden is. Je moet dus beginnen met een grondig zoekwoordenonderzoek voordat je begint met het schrijven van gidsen over een taal. De magische formule voor zoekwoorden met weinig moeite is; hoog zoekvolume en lage moeilijkheidsgraad. Je kunt Ranktracker's Keyword Finder hiervoor gebruiken. Je kunt ook kijken naar het aantal volledige gidsen die al zijn gepubliceerd om een idee te krijgen van je concurrenten. In feite, om uw concurrenten te meten, kunt u Ranktracker's SERP Checker gebruiken die u zal helpen de zwakke punten van uw concurrenten te consolideren.

Voordat je echter je primaire en secundaire trefwoorden selecteert, moet je ervoor zorgen dat de taal waarover je schrijft niet verouderd raakt of grote veranderingen ondergaat. Soms kan het gebeuren dat je het perfecte trefwoord vindt om je taalgids over te schrijven om je vervolgens te realiseren dat de naam van de taal is veranderd, bijvoorbeeld Caïro is nu Caïro 1.0 geworden. Tools zoals Ahrefs zullen je dat niet meteen laten zien.

Als een taal al een verandering heeft ondergaan, zul je die zien. Maar in sommige gevallen is een taal nog bezig met het voorstellen van veranderingen. Daarom is uitgebreid huiswerk maken over wat een taal van plan is te gaan doen ook superbelangrijk.

Tip #2 - Wees heel specifiek over de opzet van de gids

Bij het schrijven van lange gidsen over talen is een schets alles. Het maken van een overzicht is echter ook een van de moeilijkste taken. Als je gidsen schrijft voor een breder publiek, is er een vuistregel die je moet volgen: je kunt niet te eenvoudig zijn en je kunt ook niet te technisch zijn. Je moet altijd een balans vinden tussen beide.

Dit betekent dat zowel een beginnende programmeur als een expert het punt dat je maakt moet kunnen begrijpen. En je schets helpt je enorm in dit geval. Hier is het even belangrijk om te voldoen aan de intentie van de zoeker en de inhoud dienovereenkomstig te produceren.

Mijn ervaring is dat wanneer mensen zoeken naar gidsen over talen, ze meestal op zoek zijn naar praktische kennis. Je overzicht moet dus meer gericht zijn op praktijkgericht leren en minder op algemene kennis zoals de geschiedenis van een programmeertaal.

(Afbeelding overgenomen van Sulekha)

Tip #3 - Begin de gids met minder complexe dingen

Wanneer je uiteindelijk begint met het schrijven van je taalgids, zorg er dan voor dat je begint met de basis en dat je de complexiteit verhoogt naarmate je verder komt. Als je schrijft over een taal als Python, introduceer de taal dan kort en bondig vanaf het begin. Noteer alle belangrijke en leuke feiten over de taal en strooi ze in het begin. Om de lezer aan de blog te binden, is het aan te raden om statistieken toe te voegen, zoals hoeveel procent van de mensen deze taal gebruikt, enz. Je kunt het ook zien als het beantwoorden van het _wie, wanneer, _en _waarom _van een taal.

Dan moet je een aantal populaire projecten noemen die zijn gecodeerd met deze specifieke programmeertaal. In veel gevallen zijn mensen zich er niet van bewust dat een applicatie die ze dagelijks gebruiken gedeeltelijk of volledig in een bepaalde programmeertaal is gecodeerd. Hierdoor raken ze geïntrigeerd en nieuwsgierig en blijven ze lezen. In feite maakt het af en toe vermelden van deze leuke weetjes in de gids de gids smakelijker voor minder ervaren programmeurs.

Je kunt ook overwegen om een vergelijking te maken tussen de hoofdtaal en zijn concurrent. Dit zal de lezer een nieuw perspectief bieden. Probeer al met al de eerste 500-600 woorden te besteden aan de introductie van de taal. Maar probeer deze limiet niet te overschrijden.

Tip #4 - Richt je aandacht op het vlezige gedeelte van de gids

Zoals gezegd zijn mensen die online naar geschreven gidsen zoeken, op zoek naar praktische tips en de specifieke kenmerken van de taal. Je zult ook een patroon zien wanneer je de documentatie van een programmeertaal leest. Sommige dingen zijn constant in alle talen. Deze omvatten datatypes, variabele types, frameworks, bibliotheken, tools, enz.

Dit toont aan dat deze specifieke kenmerken niet in het gedrang kunnen komen en altijd moeten worden vermeld. Hoewel elke programmeertaal een aantal verschillende frameworks, bibliotheken en tools heeft, moet je voor elke taal 3 populaire elementen kiezen en deze toevoegen. De officiële GitHub accounts van de talen kunnen je hierbij aanzienlijk helpen.

Nu vraag je je misschien af, als deze details al op GitHub staan, waarom zou je ze dan toevoegen aan je gids? Nou, informatie op GitHub heeft de neiging om moeilijk te navigeren te zijn, omdat er honderden bestanden zijn. Dus, focussen op de belangrijke stukjes zal enorm helpen, omdat je een gat opvult door de lezers snel te voorzien van de top 3 bibliotheken, frameworks, tools, etc. Bovendien zullen de lezers ook in staat zijn om het meeste uit de gids te halen.

Tip #5 - Verdubbel het leerproces

Als je begonnen bent met het schrijven van het hoofdgedeelte van de gids, waarin je taalspecificaties opneemt, moet je ervoor zorgen dat je waarde toevoegt aan de lezer door praktisch toe te passen wat je hebt geschreven.

De meeste gidsen die tegenwoordig op internet beschikbaar zijn, bevatten geen codering. Als je een niet-technische achtergrond hebt, ben je je ook niet bewust van codering. Echter, het vermelden van basisstappen voor codering in het artikel, vooral het gebruik van de frameworks en bibliotheken en tools die je hebt genoemd, kan je gids waardevoller maken.

Maar hoe kun je coderen als je er niets vanaf weet? Dit is waar je hulp kunt krijgen van Bard of ChatGPT of Ranktracker's AI Article Writer om je te helpen, bijvoorbeeld met het coderen van het eenvoudigste slimme contract, in 3 eenvoudige stappen. Je kan het laten nakijken door een bevriende coder of kennis, of het posten op een coder's forum om er zeker van te zijn dat wat je geschreven hebt correct is.

Dit draagt bij aan je authenticiteit en autoriteit als blog-eigenaar of schrijver.

Concluderend,

Het schrijven van lange technische handleidingen is geen gemakkelijke taak, vooral als je niet veel kennis hebt van het programmeerjargon. Er zullen verschillende uitdagingen zijn. Maar als je eenmaal je eerste 2-3 programmeertaalgidsen hebt geschreven, zul je de dingen onder de knie krijgen. Het werkt als een proces. Hoewel de bovenstaande tips misschien niet de meest nauwkeurige formule zijn voor het schrijven van gidsen over programmeertalen, kunnen ze je zeker helpen om je gidsen op elkaar af te stemmen en er structuur in aan te brengen als iemand die geen technische achtergrond heeft.