Slik skriver du om programmeringsspråk uten teknisk bakgrunn

Introduksjon

Skriving har alltid vært en lidenskap for meg. Da jeg fikk jobb som Web3-skribent for et ed-tech-selskap, var jeg i ekstase. Ifølge Social Media Today leser 77 % av internettbrukerne blogger. Jobben ga meg muligheten til å introdusere verden for arbeidet mitt.

Mens jeg dagdrømte om hvordan jeg skulle få et lojalt publikum og en internasjonal leserskare i løpet av de neste par månedene, ble jeg bedt av sjefen min om å skrive guider om ulike programmeringsspråk som er mye brukt på Web3-området. Siden jeg ikke har teknisk bakgrunn, føltes dette som en vanskelig oppgave.

Men etter mye prøving og feiling nådde jeg til slutt et punkt der jeg hadde funnet en oppskrift på hvordan jeg kunne skrive lange guider om ulike programmeringsspråk, og det på en måte som en person med teknisk bakgrunn ville skrevet.

I denne bloggen vil jeg derfor dele fem tips som har spart meg tid og energi og hjulpet meg med å skrive tekniske og faktamessig korrekte guider som kan rangere på Google.

(Bilde av Metaschool)

Hvorfor bør du skrive guider om tekniske emner?

Før denne guiden hopper til formelen, la oss først forstå hvorfor det er viktig å skrive guider om tekniske emner og hvorfor det kan gi gode resultater for bloggen din.

Først og fremst er tekniske guider en fin måte å komme i kontakt med et publikum på og dele kunnskap og ferdigheter på. Teknisk innhold er imidlertid også veldig nisjespesifikt. Det er lite sannsynlig at du skriver slike guider hvis du har en livsstilsblogg. Men i takt med at nye teknologiske fremskritt som kunstig intelligens og blockchain har fått stadig større gjennomslagskraft, ser vi en økning i antallet teknologirelaterte blogger. Mange har sine egne AI-støttede produkter. Her kan teknisk skriving spille en viktig rolle når det gjelder å drive trafikk til bloggen og produktet ditt.

For det andre er det ingen tvil om at det i dag er YouTube som gjelder når du vil lære noe teknisk. Det finnes hundretusener av videoer og veiledninger. Plassen er ganske mettet, om du vil. Nå lurer du kanskje på at hvis det nødvendige materialet allerede er tilgjengelig på YouTube, hvorfor skulle noen ønske å skrive lange veiledninger? Vel, der har du svaret. Alle rundt deg tenker mer eller mindre på samme måte. Folk fokuserer på å lage mer og mer videoinnhold, og innser ikke at de også kan bygge opp et publikum ved å skrive innhold.

For det tredje, hvis vi snakker om programmeringsspråk, finnes det ikke mange skriftlige veiledninger på Internett. Dokumentasjonen som er tilgjengelig på de offisielle nettsidene, har en tendens til å være ordrik og inneholde mye informasjon. Guider konsoliderer i hovedsak all tilgjengelig informasjon fra et språks lange dokumentasjon, oppsummerer den og deler en mer oversiktlig og lettnavigerbar versjon for å imøtekomme publikum som foretrekker å lese.

Til slutt, for å gjenta, hvis du har en virksomhet som dreier seg om teknologi, Web3 og AI, er det å skrive guider den raskeste måten å hjelpe deg med å rangere for forskjellige søkeord og bringe virksomheten din i forgrunnen. Dette er noen av grunnene til at du bør vurdere å skrive guider om tekniske emner hvis du har en blogg eller virksomhet i en lignende nisje.

Tips #1 - Velg med omhu hvilke språk du vil skrive guidene dine på

Det første trinnet er å trå varsomt, for du bør ikke skrive en guide om et språk, for eksempel Solidity, som allerede er vanskelig å rangere på. Derfor bør du begynne med grundig søkeordsanalyse før du begynner å skrive guider om et språk. Den magiske formelen for søkeord med lav innsats er høyt søkevolum og lav vanskelighetsgrad. Du kan bruke Ranktrackers Keyword Finder til dette. Du kan også sjekke hvor mange guider i full lengde som allerede er publisert, for å få et inntrykk av konkurrentene dine. For å måle konkurrentene dine kan du faktisk bruke Ranktracker's SERP Checker som vil hjelpe deg med å konsolidere de svake punktene til konkurrentene dine.

Før du velger ut primære og sekundære søkeord, må du imidlertid forsikre deg om at språket du skriver om, ikke er i ferd med å bli foreldet eller gjennomgår store endringer. Noen ganger kan du ende opp med å finne det perfekte søkeordet å skrive språkguiden din på, bare for å innse at språkets navn har endret seg, for eksempel at Cairo nå er Cairo 1.0. Verktøy som Ahrefs viser deg ikke dette umiddelbart.

Hvis et språk allerede har gjennomgått en endring, vil du se det. Men i noen tilfeller kan et språk fortsatt være i ferd med å foreslå endringer. Derfor er det også svært viktig å gjøre omfattende hjemmelekser om hva et språk har tenkt å gjøre videre.

Tips nr. 2 - Vær veldig spesifikk med hensyn til guideoversikten

Disposisjonen er alfa og omega når du skal skrive lange språkguider. Men å lage disposisjoner er også en av de vanskeligste oppgavene. Når du skriver guider for et bredere publikum, er det en tommelfingerregel du må følge: Du kan ikke være for enkel, og du kan heller ikke være for teknisk. Du må alltid finne en balanse mellom begge deler.

Det betyr at både en nybegynner og en ekspert skal kunne forstå og gripe poenget ditt. Og her er disposisjonen din til stor hjelp. Her er det like viktig å oppfylle søkerens intensjon og produsere innholdet deretter.

Min erfaring er at når folk søker etter guider om språk, er de som regel ute etter praktisk kunnskap. Derfor bør oversikten din være mer fokusert på praktisk læring og mindre på generisk kunnskap, som for eksempel et programmeringsspråks historie.

(Bilde hentet fra Sulekha)

Tips nr. 3 - Begynn guiden med mindre komplekse ting

Når du endelig begynner å skrive språkguiden din, bør du begynne med det grunnleggende og deretter øke kompleksiteten etter hvert. Hvis du skriver om et språk som Python, bør du gi en kort og konsis introduksjon fra begynnelsen. Skriv ned alle viktige og morsomme fakta om språket og dryss dem ut i begynnelsen. For å fenge leseren til bloggen anbefales det å legge til statistikk som hvor mange prosent av befolkningen som bruker dette språket osv. Du kan også tenke på det som å svare på _hvem, når, _og _hvorfor _for et språk.

Deretter må du nevne noen av de populære prosjektene som er kodet i dette programmeringsspråket. I mange tilfeller er folk ikke klar over at et program de bruker til daglig, helt eller delvis er kodet i et bestemt programmeringsspråk. Dette gjør dem nysgjerrige og nysgjerrige, og de fortsetter å lese. Hvis du nevner disse morsomme faktaene innimellom i guiden, blir den faktisk mer spiselig for mindre erfarne programmerere.

Du kan også vurdere å sammenligne hovedspråket med et konkurrerende språk. Dette vil gi leseren et nytt perspektiv. Alt i alt bør du bruke de første 500-600 ordene på å introdusere språket. Men prøv å ikke gå utover denne grensen.

Tips nr. 4 - Fokuser på den mest innholdsrike delen av guiden

De som leter etter skriftlige guider på nettet, er som nevnt ute etter praktiske tips og detaljer om språket. Du vil også se et mønster når du leser dokumentasjonen til et programmeringsspråk. Noen ting går igjen i alle språkene. Det gjelder blant annet datatyper, variabeltyper, rammeverk, biblioteker, verktøy osv.

Dette viser at man ikke kan gå på akkord med disse detaljene, og at de alltid bør nevnes. Selv om hvert programmeringsspråk har en rekke ulike rammeverk, biblioteker og verktøy, bør du velge ut tre populære elementer for hvert språk og legge dem til. Språkenes offisielle GitHub-kontoer kan være til stor hjelp i dette arbeidet.

Nå lurer du kanskje på hvorfor du skal legge til disse opplysningene i guiden din hvis de allerede finnes på GitHub? Vel, informasjon på GitHub har en tendens til å være vanskelig å navigere fordi det er hundrevis av filer. Å fokusere på de viktigste bitene vil derfor være til stor hjelp, ettersom du fyller et hull ved raskt å gi leserne de tre beste bibliotekene, rammeverkene, verktøyene osv. Dessuten vil leserne også kunne få mest mulig ut av guiden.

Tips nr. 5 - Dobbelt opp på læringsdelen

Når du har begynt å skrive hoveddelen av veiledningen, som inneholder språklige detaljer, bør du sørge for at du gir leseren verdi ved å anvende det du har skrevet i praksis.

De fleste guider som er tilgjengelige på internett i dag, omfatter ikke koding. Hvis du ikke har en teknisk bakgrunn, vil du heller ikke ha kjennskap til koding. Men hvis du nevner grunnleggende kodingstrinn i artikkelen, spesielt ved hjelp av rammeverkene, bibliotekene og verktøyene du har nevnt, kan du gjøre guiden din mer verdifull.

Men hvordan kan du kode hvis du ikke vet noe om det? Her kan du få hjelp av Bard eller ChatGPT eller Ranktrackers AI Article Writer til å hjelpe deg med å kode for eksempel den enkleste smartkontrakten i tre enkle trinn. Du kan få den sjekket av en kodevenn eller bekjent, eller legge den ut på et kodeforum for å forsikre deg om at det du har skrevet, er riktig.

Dette øker din autentisitet og autoritet som bloggeier eller skribent.

For å oppsummere,

Det er ikke lett å skrive lange tekniske veiledninger, spesielt ikke når du ikke har mye kunnskap om programmeringssjargongen. Det kan by på mange utfordringer. Men når du først har skrevet de første 2-3 guidene for programmeringsspråk, vil du få greie på det. Det fungerer som en prosess. Selv om tipsene nevnt ovenfor kanskje ikke er den mest nøyaktige formelen for å skrive guider om programmeringsspråk, kan de helt sikkert hjelpe deg med å justere og strukturere guidene dine når du ikke har teknisk bakgrunn.