Kuidas kirjutada suurepärast tehnilist blogipostitust

Viis sammu ideest lihvitud tulemuseni jõudmiseks

Olen töötanud avatud lähtekoodiga kogukonnas juba peaaegu 5 aastat, arendades ja reklaamides arendaja tööriistu, sealhulgas Meteorit ja Apollot. Selle aja jooksul olen leidnud, et blogimine on üks tõhusamaid viise ideede levitamiseks.

Blogipostituse ettevalmistamine ei võta nii kaua aega kui video- või konverentskõne, kuid seda on lihtne tarbida ja see võib jõuda paljude inimesteni. Olen ka ise kirjutamisest palju kasu saanud: see on aidanud mul oma mõtteid korrastada, õpetada inimestele tehnoloogiaid, mida armastan, ja oma nime seal välja tuua.

Alates oma esimese ajaveebipostituse avaldamisest 2014. aastal olen kirjutanud siiani siia Mediumisse 68 postitust, mõned üle 50 000 vaatamise ja 1000 fänniga ning muutnud palju postitusi oma sõpradele ja töökaaslastele. Selle aja jooksul olen üles valinud mõned strateegiad postituse ideest väljaandesse viimiseks.

Selles artiklis käsitleme minu postituse kirjutamise protsessi viit peamist etappi:

  1. Leidke hea teema ja pühenduge sellele
  2. Muutke oma eesmärgid ja vaatajaskond konkreetseks
  3. Kas teil on algus, keskpaik ja lõpp
  4. Hankige tagasisidet ja korrake
  5. Lisage viimistlus: pakendamine, avaldamine ja reklaam

Läheme kohe esimesse sammu!

1. Leia hea teema ja pühendu sellele

Postitusega ei saa alustada, kui teil pole millestki kirjutada! Kui räägin inimestega, kes soovivad hakata blogima, on see sageli nende peamine blokeerija.

Lihtsaim strateegia on kirjutada sellest, mida teate. Kui veetsite mitu tundi millegi õppimiseks ja arvate, et saaksite seda mõne minutiga selgitada, pakute oma lugejatele palju väärtust.

Teine idee on kirjutada alast, mis teie arvates puudub. Näiteks pole praegu palju postitusi selle kohta, kuidas kandideerida tehnilistele konverentsidele, nii et selle sisu võib täita tühimiku kogukonnas.

Siin on mõned konkreetsed postituste tüübid, kuhu võiksite minna. Näited pärinevad GraphQL-iga seotud postitustest Apollo ajaveebis:

  1. Samm-sammuline juhend konkreetse eesmärgi saavutamiseks: „Suurepärase keritava loendi loomine rakenduses React Native with FlatList“ või „Lihtsustage oma Reacti komponente Apollo ja uuesti komponeerimise abil“. Need on suurepärased lugejatele, kes soovivad kiiresti sisse saada, midagi ära teha ja välja tulla.
  2. Põhjalik küsitlus konkreetsel teemal: „nullimise kasutamine GraphQL-is” või „GraphQL-i päringu anatoomia”. Need on kasulikud, kui sihite rohkem huvitatud publikut, kes soovib haarata tassi kohvi ja õppida tonni.
  3. Numbriline loetelu kasulikke fakte levinud teema kohta: „4 lihtsat viisi GraphQL API kutsumiseks“ või „Staatiliste GraphQL päringute viis eelist“. Need on lõbusad ja lihtsad lugemised, kuna te ei pea pühenduma kogu asja lugemisele ja hammustussuuruste tükkide tarbimine on lihtne.

Lubage mul nüüd hajutada mõned levinud probleemid:

  1. Selle teema kohta on juba sisu olemas. Ära lase sellel end peatada. Isegi kui teie ideest on varem kirjutatud, võite sellele oma vaatenurga panna või oma olukorrale vastavaks muuta.
  2. Minu idee pole piisavalt huvitav. Paljud mu sõbrad ja töökaaslased ei kirjuta lõpuks, sest nad on mures, et nende järeldused võivad olla igavad või ilmsed. See on normaalne tunne! Kui olete ekspert midagi, siis muidugi järeldused olete kirjalikult umbes saab igav ... teile . Peamine on see, et teie vaatajaskonna inimesed ei tea seda kraami veel.

Kõike seda öeldes on päeva lõpuks raske ennustada, millistest teemadest saab suurepärase postituse ja millistest mitte ning sageli on postituse teinud või rikkunud just teostus , mitte hiilgav teema. Minu peamine ettepanek oleks proovida kirjutada mitmest erinevast asjast ja vaadata, mis töötab.

2. Muutke oma eesmärgid ja publik konkreetseks

Nüüd, kui teate oma teemat, vajate oma postituse jaoks vaatajaskonda ja eesmärki. Kes seda loevad ja mida nad sellest saavad?

Teie eesmärk peab olema konkreetne , et saaksite kogu oma energia suunata ühele põhiideele. Selle postituse jaoks ei saanud eesmärk olla lihtsalt kirjutada blogimisest. Mul oli vaja konkreetsemat eesmärki silmas pidada:

  • Publik: inimesed, kes soovivad hakata blogima, eriti tehnilistel teemadel, kuid pole seda veel teinud.
  • Eesmärk: andke inimestele konkreetne sammude ja näpunäidete komplekt, et nad saaksid alustada.

Kui need on olemas, hoidke oma postitus fookuses, eemaldades kõik, mis ei aita, ja vältige lisadetailide lisamist lihtsalt sellepärast, et see on seotud. Olen avastanud, et kõige lühemad postitused, mille lugemisaeg on 5–10 minutit, on kõige edukamad.

Vaatajaskonna tausta teadmine võimaldab teil kohandada oma kirjutisi vastavalt nende olemasolevatele teadmistele ja aitab kindlaks teha, kuidas peaksite oma sisu avaldama ja reklaamima. Näiteks loodan selle avaldada saidil freeCodeCamp, sest paljud minu sihtgrupi inimesed võivad seda väljaannet juba lugeda.

3. Kas teil on algus, keskpaik ja lõpp

See on desorienteeriv, kui postitus liigub suunas, mida te ei oodanud. Süžee keerdkäikudest võib olla väljamõeldud novellides suur kasu, kuid tehnilist artiklit on lihtsam tarbida, kui saate täpselt selle, mida ootate. Oma postitustele mugava ülesehituse andes saate oma lugejaid õigel kursil hoida.

Sissejuhatus

Teie postituse esimene lõik või kaks veenavad lugejat püsima jääma või kaotavad tähelepanu. Alustage pisut kontekstist, et aidata inimestel mõista, kuhu teie postitus suures pildis sobib. Seejärel rääkige oma publikule, mida nad teie artikli lugemisest saavad. Võib-olla on ahvatlev jätta suur paljastus lõpuni, kuid olge ettevaatlik: kui teil pole head konksu, ei jää teie lugejad selle avastamiseks ringi.

Keskmine

Nüüd, kui olete oma lugejatele öelnud, mida oodata, andke see neile! Minge julgelt nii palju üksikasju kui vaja, ja jätke inimeste orienteerimiseks teeviidad. Kasutage paljusid päiseid, nummerdatud loendeid ja vorminguid, et aidata inimestel mõista oma asukohta ja võimaldada neil liikuda edasi kõige rohkem huvitava sisu juurde.

Järeldus

Ärge lihtsalt kitsendage artikli lõpus olevasse tühimikku. Kui teie lugeja on selle kogu tee saavutanud, hoolib ta sellest tõesti. Andke neile kiire kokkuvõte õpitu kohta, pai lugemiseks ja võib-olla isegi midagi järgmist teha, kui neid inspireeritakse - üleskutse tegevusele.

Siin pakutav formaat pole kõige loomingulisem ja kindlasti on selleks ka muid võimalusi. Kuid lihtne ülesehitus on kõige otsesem viis oma lugejatega suhelda.

4. Hankige tagasisidet ja korrake

Te ei tea, mida inimesed teie kirjutisest saavad, enne kui nad seda loevad. Siin pannakse tõesti proovile teie oletused oma teema, eesmärkide, postituse üksikasjade ja struktuuri kohta. Kui soovite head tulemust, ei saa te seda sammu vahele jätta.

Võib tunduda, et te kehtestate tagasisidet küsides impulsse või võite olla mures, et see on negatiivne, kuid inimesed on rohkem valmis aitama kui te arvate. Enne maailmas avaldamist on palju parem teada saada, kuidas teie postitus võiks parem olla. Seda postitust kokku pannes sain üliväärtuslikku tagasisidet, mis muutis sisu palju paremaks ja fokuseeritumaks.

Mida peaksite oma retsensentidelt küsima? Minu peamine nõuanne on jätta see võimalikult tähtajatu. Püüa mitte ette selgitada, mida sa tahtsid saavutada. Andke mustand üle sellisena, nagu see on, ja küsige arvustajalt, mida nad sellest said või mida tuleks muuta. Kui keegi Internetis teie artikliga kokku puutub, pole tal mingit lisakonteksti ja see peab iseseisvalt seisma.

Peamine asi, mida tagasiside põhjal kinnitada, on: kas selle postitusega saavutatakse eesmärgid, mille olete 2. etapis otsustanud? Korduvad seni, kuni olete kindel, et see nii on.

5. Lisage viimistlus: pakendamine, avaldamine ja reklaam

Nüüd, kui teil on idee, eesmärk, struktuur ja tagasisidet, on aeg kõik lihvida ja kohale toimetada.

Pakendamine

Tulge välja suurepärase pealkirja ja alapealkirjaga ning veenduge, et teie postitusel oleks vähemalt üks pilt. Seda näevad inimesed, kui postitust Twitteris või Facebookis jagatakse, ja see on teie võimalus tekitada inimestes lugemishuvi.

Samuti on oluline, et teie postitus näeks välja ja tunduks professionaalne, et teie sisu saaks tõeliselt särada. Peaksite püüdma, et teie postituses ei oleks õigekirjavigu, grammatikavigu ega veidrat vormindust. Kui teil on sõber, kes oskab suurepäraselt pisidetaile märgata, paluge tal see enne avaldamist üle lugeda.

FreeCodeCampi artiklis avaldamise kohta on ka häid näpunäiteid kirjutamisstiili ja vormingu kohta. Kuna olete oma postituses juba nii palju tööd teinud, on seda väärt, et lisada see väike lisapingutus, et seda tõeliselt lihvida ja laiema haarde tagamiseks.

Lõpuks tehke kindlasti au kõigile, kelle tööle viitasite või kes aitas teie postitust üle vaadata ja muuta.

Avaldamine

Sa oled peaaegu kohal! Valige postituse tegelikult avaldamise koht, et sellel oleks parimad võimalused oma vaatajaskonnani jõuda. Keskmine on üldiselt suurepärane koht tehnilise sisu jaoks ja muudab inimestel teie kirjutise avastamise lihtsaks.

Boonuspunktide saamiseks proovige oma postitus saada asjakohasesse väljaandesse, mis aitab teie sisu jagada - sel juhul olen valinud freeCodeCamp, sest arvan, et see nõuanne on nende lugejatele asjakohane. Kui soovite sama teha, siis siin on nende juhised postituse esitamiseks. Teie huvipakkuvates väljaannetes otsitakse tõenäoliselt ka postitusi, nii et ärge kartke ühendust võtta!

Edutamine

Kui olete postituse tegelikult avaldanud, pole see veel valmis! Kui soovite, et inimesed näeksid teie kirjutatut ja saaksid sellest väärtust, jagage seda kindlasti kohtades, kus teie publik tõenäoliselt hängib. See võib hõlmata Facebooki gruppe, Reddit, Hacker News, LinkedIn või mõnda muud platvormi. Jagage kindlasti ka oma loomingut oma sotsiaalmeedia kontodel, näiteks Twitteris. Teie sõbrad on põnevil teie kirjutatut lugema, jagama ja hääletama!

Ja nüüd olete valmis. Minge kohvi jooma või jalutama - blogipostituse tegemine algusest lõpuni pole sugugi väike saavutus. Lugege kogukonna tagasisidet ja vastuseid, et saaksite end edasi arendada. Ja kui teil on veel üks idee, siis tehke seda uuesti!

Tava ei asenda midagi

Käisime just läbi viis kõige olulisemat toimingut, mida blogipostituse kirjutamisel teha, alates idee väljapakkumisest kuni avaldamiseni. Nüüd, kui olete selle läbi lugenud, proovite seda nõuannet rakendada ja vaadata, mis teile sobib.

Jätan teile veel viimase nõuande. Peamine asi, mida viimase 3 aasta jooksul blogimisest õppisin, on see, et ma ei oska absoluutselt ennustada, mis sisu ära võtab ja mis lõpuks totaalseks mölluks jääb. Mõnikord panen mitu päeva postitusse, lihvides iga nurka ja see ei kao kuhugi. Teiselt poolt kirjutati “GraphQL vs. REST”, minu kõigi aegade kõige loetum postitus, mõne tunni jooksul hilisõhtul.

Nii et isegi kui teie esimene, teine ​​või kolmas postitus ei õnnestu, proovige jätkuvalt uusi asju, pange oma ideed välja ja parandage aja jooksul. Maailm tahab kuulda, mida sul öelda on. Mine ütle neile!

Suur tänu Anvisha Pai, Angela Zhangile, Katie Siegelile ja freeCodeCampi toimetajatele, kes aitasid seda postitust üle vaadata.