Hogyan lehet nagyszerű technikai blogbejegyzést írni

Öt lépés az ötlettől a csiszolt eredményig

Majdnem 5 éve dolgozom a nyílt forráskódú közösségben, fejlesztőeszközöket építve és népszerűsítve a Meteort és az Apollót. Ez idő alatt rájöttem, hogy a blogolás az egyik leghatékonyabb módszer az ötletek terjesztésére.

A blogbejegyzés elkészítése nem tart olyan sokáig, mint egy video- vagy konferenciabeszélgetés, de könnyen fogyasztható és rengeteg emberhez eljuthat. Személyesen is rengeteg hasznot hoztam az írásból: ez segített abban, hogy rendszerezzem a gondolataimat, megtanítsam az embereket az általam szeretett technológiákra, és megszerezzem a nevemet.

Az első blogbejegyzésem 2014-es közzététele óta eddig 68 bejegyzést írtam itt a Médiumon, néhányat több mint 50 ezer megtekintéssel és 1000 rajongóval, valamint sok bejegyzést szerkesztettem barátaimnak és munkatársaimnak. Ez alatt az idő alatt néhány stratégiát választottam a bejegyzés fogalmától publikációig történő felvételére.

Ebben a cikkben áttekintjük a bejegyzés írásának folyamatának öt fő lépését:

  1. Keressen egy jó témát és vállalja el
  2. Tegye egyedivé céljait és közönségét
  3. Legyen eleje, közepe és vége
  4. Visszajelzés és iterálás
  5. Adjon hozzá simításokat: csomagolás, közzététel és promóció

Menjünk rögtön az első lépésbe!

1. Keressen egy jó témát és vállalja el

Csak akkor kezdheti el a bejegyzést, ha van miről írnia! Amikor olyan emberekkel beszélgetek, akik el akarnak kezdeni blogolni, gyakran ez a fő blokkolójuk.

A legegyszerűbb stratégia az, ha arról írsz, amit tudsz. Ha sok órát töltött azzal, hogy valamit megtudjon, és úgy gondolja, hogy néhány perc alatt meg tudja magyarázni, akkor rengeteg értéket fog biztosítani olvasói számára.

Egy másik ötlet egy olyan területről írni, amelyről úgy gondolja, hogy hiányzik a tartalma. Például jelenleg nincs sok bejegyzés arról, hogy miként lehet jelentkezni a technikai konferenciákra, így az erről szóló tartalom hiánypótló lehet a közösségben.

Íme néhány olyan típusú bejegyzés, amelyre mehet. Példák az Apollo blog GraphQL-hez kapcsolódó bejegyzéseiből:

  1. Lépésenkénti útmutató egy adott cél eléréséhez: „Remek görgethető lista készítése a React Native with FlatList segítségével” vagy „A React összetevőinek egyszerűsítése az Apollo és az Újrakomponálás segítségével”. Ezek nagyszerűek azoknak az olvasóknak, akik szeretnének bejutni, tenni valamit és gyorsan kijönni.
  2. Alapos felmérés egy adott témáról: „A semmisség használata a GraphQL-ben” vagy „A GraphQL-lekérdezés anatómiája”. Ezek akkor hasznosak, ha egy érdeklődőbb közönséget céloz meg, aki meg akar ragadni egy csésze kávét és rengeteg mindent megtanul.
  3. Hasznos tények számozott listája egy közös témakörben: „4 egyszerű módszer a GraphQL API meghívására” vagy „A statikus GraphQL lekérdezések 5 előnye”. Ez egy szórakoztató, könnyű olvasmány, mivel nem kell elköteleznie magát az egész elolvasása mellett, és könnyű elfogyasztani a harapásméretű darabokat.

Engedjék meg, hogy eloszlassak néhány általános problémát:

  1. Már létezik tartalom erről a témáról. Ne hagyd, hogy ez megállítson. Még akkor is, ha az ötletéről korábban már írtak, megteheti a saját perspektíváját, vagy sajátossá teheti azt a helyzetéhez.
  2. Az ötletem nem elég érdekes. Sok barátom és munkatársam végül nem ír, mert attól tartanak, hogy következtetéseik unalmasak vagy nyilvánvalóak lehetnek. Ez normális érzés! Ha valamiben szakértő vagy, akkor a következtetések, amelyekről írsz, természetesen unalmasak lesznek ... számodra . A legfontosabb, hogy a közönséged tagjai még nem ismerik ezeket a dolgokat.

Mindezt elmondva, a nap végén nehéz megjósolni, hogy mely témákból lesz nagyszerű bejegyzés, és melyekből nem, és gyakran a végrehajtás teszi vagy bontja meg a bejegyzést, nem pedig ragyogó téma. Legfőbb javaslatom az lenne, hogy próbáljak meg többféle dolgot írni és megnézni, mi működik.

2. Tegye egyedivé céljait és közönségét

Most, hogy ismeri a témáját, közönségre és célra van szüksége a bejegyzéséhez. Ki fogja olvasni, és mit fognak kihozni belőle?

A cél az kell, hogy legyen konkrét , így a hangsúly az összes energia egyik fő gondolata. Ennek a bejegyzésnek a célja nem csupán az lehetett, hogy „írjon a blogolásról”. Konkrétabb célra volt szükségem:

  • Közönség: Olyan emberek, akik blogolni szeretnének, főleg technikai témákról, de még nem tették meg.
  • Cél: Adjon meg az embereknek konkrét lépéseket és mutatókat, hogy elindulhassanak.

Ha ezek megvannak, tartsa a bejegyzés fókuszában, eltávolítva mindent, ami nem járul hozzá, és kerülje a további részletek megadását, csak mert összefüggenek. Megállapítottam, hogy a viszonylag tömör, 5-10 perces olvasási idejű bejegyzések a legsikeresebbek.

A közönség hátterének ismerete lehetővé teszi, hogy írását a meglévő ismereteihez igazítsa, és segítsen meghatározni, hogyan kell közzétenni és népszerűsíteni a tartalmát. Remélem például, hogy ezt közzéteszem a freeCodeCamp oldalon, mert a célközönségemben sokan olvashatják már azt a kiadványt.

3. Legyen eleje, közepe és vége

Dezorientáló, amikor egy poszt olyan irányba tér le, amire nem számított. A cselekményfordulatok nagy előnyt jelenthetnek a kitalált novellákban, de könnyebb egy technikai cikket fogyasztani, ha pontosan azt kapja, amire számít. Az olvasóit jó úton tarthatja, ha a bejegyzésének kényelmes szerkezetet ad.

Bevezetés

A hozzászólásod első vagy két bekezdése vagy meggyőzi az olvasót, hogy maradjon, vagy elveszíti figyelmét. Kezdjen egy kis kontextussal, hogy segítsen az embereknek megérteni, hogy a bejegyzés hol fér bele az összképbe. Ezután mondja el közönségének, mit hoz majd abból, ha elolvassa a cikkét. Csábító lehet a nagy leleplezést a végére hagyni, de vigyázz: ha nincs jó horgod, olvasóid nem ragaszkodnak hozzá, hogy megtudják.

Középső

Most, hogy elmondta olvasóinak, mire számíthat, adja át nekik! Nyugodtan részletezzen annyi részletet, amennyire szüksége van, és hagyjon útjelző táblákat az emberek tájékozódása érdekében. Használjon sok címsort, számozott listát és formázást, hogy segítse az embereket abban, hogy megértsék, hol vannak, és lehetővé teszik számukra, hogy áttérjenek a leginkább érdeklő tartalomra.

Következtetés

Ne csak szűküljön a cikk végén található üregbe. Ha olvasója egészen odaért, akkor nagyon érdekli őket. Adj nekik egy gyors összefoglalót a tanultakról, verj egy hátat az olvasásért, és talán még valamit is csinálj, ha inspirálódnak - cselekvésre ösztönzés.

Az általam itt javasolt formátum nem a legkreatívabb, és ennek biztosan vannak más módjai is. De az egyszerű struktúra a legközvetlenebb módja az olvasókkal való kommunikációnak.

4. Visszajelzés és iterálás

Addig nem tudhatod, hogy az emberek mit fognak kapni az írásodból, amíg el nem olvassák. Itt kerülnek igazán próbára a feltételezései a témával, a célokkal, a bejegyzés részleteivel és a felépítéssel kapcsolatban. Ha jó eredményt szeretne elérni, akkor ezt a lépést nem hagyhatja ki.

Úgy tűnhet, mintha impozáns lenne, ha visszajelzést kér, vagy aggódhat, hogy negatív lesz, de az emberek szívesebben segítenek, mint várná. Sokkal jobb, ha megtudod, hogy lehetne jobb a bejegyzésed, mielőtt közzétennéd a világon. Amikor összeállítottam ezt a bejegyzést, szuper értékes visszajelzéseket kaptam, amelyek sokkal jobbá és koncentráltabbá tették a tartalmat.

Mit kell kérdeznie a bírálóitól? Legfőbb tanácsom, hogy hagyjam a lehető legnyitottabb. Ne próbáld előre megmagyarázni, mit akartál elérni. Adja át a piszkozatot úgy, ahogy van, és kérdezze meg véleményezőjét, mit hoztak ki belőle, vagy mit kellene megváltoztatni. Ha valaki az interneten találkozik a cikkével, akkor nem lesz semmi további kontextusa, és önállóan kell állnia.

A visszajelzések alapján a legfontosabb, hogy érvényesítsük-e a bejegyzéssel azokat a célokat, amelyekről a 2. lépésben döntöttek? Addig iterálj, amíg nem vagy biztos benne.

5. Adjon hozzá simításokat: csomagolás, közzététel és promóció

Most, hogy megvan az ötlet, a cél, a felépítés és némi visszajelzés, itt az ideje, hogy mindent csiszoljon és elküldjön.

Csomagolás

Jöjjön elő egy remek címmel és felirattal, és győződjön meg róla, hogy a bejegyzésén legalább egy kép található. Ezt látják az emberek, amikor a bejegyzést megosztják a Twitteren vagy a Facebookon, és ez az Ön esélye arra, hogy az embereket érdekelje az olvasás.

Fontos az is, hogy a bejegyzés profinak tűnjön és jól érezze magát, hogy tartalma valóban ragyoghasson. Arra kell törekednie, hogy ne legyenek helyesírási hibák, nyelvtani hibák vagy furcsa formázás a bejegyzésben. Ha van olyan barátod, aki remekül észreveszi az apró részleteket, kérje meg őket, hogy olvassák el, mielőtt közzéteszik.

A közzétételről szóló freeCodeCamp cikk tartalmaz néhány nagyszerű tippet az írás stílusával és a formázással kapcsolatban. Mivel már annyi munkát fektett be a bejegyzésébe, érdemes megadnia azt a kis plusz erőfeszítést, hogy valóban csiszolhassa és szélesebb körben nyújthassa.

Végül mindenképpen írjon be mindenkit, akinek a munkájára hivatkozott, vagy aki segített átnézni és szerkeszteni a bejegyzését.

Kiadvány

Majdnem ott vagy! Válassza ki, hogy valójában hol publikálja a bejegyzést, hogy a lehető legnagyobb eséllyel elérje közönségét. A Médium általában kiváló hely a technikai tartalom számára, és megkönnyíti az emberek számára, hogy felfedezzék írásodat.

A bónuszpontokért próbáld meg beírni a bejegyzésedet egy releváns kiadványba, amely segít megosztani a tartalmadat - ebben az esetben azért választottam a freeCodeCamp-et, mert úgy gondolom, hogy ez a tanács releváns lesz olvasóik számára. Ha ugyanezt szeretné megtenni, itt találja a bejegyzés elküldésével kapcsolatos útmutatásokat. Az érdeklődési körödben lévő publikációk valószínűleg szintén keresnek bejegyzéseket, ezért ne félj kapcsolatba lépni!

promóció

Miután ténylegesen közzétette a bejegyzést, nem végzett! Ha azt akarod, hogy az emberek lássák, amit írtál, és hogy kiaknázzák belőle, feltétlenül ossza meg azokat olyan helyeken, ahol a közönség valószínűleg lógni fog. Ez magában foglalhatja a Facebook csoportokat, a Reddit, a Hacker News, a LinkedIn vagy bármely más platformot. Ezenkívül feltétlenül ossza meg alkotásait saját közösségi médiafiókjain, például a Twitteren. A barátaid örömmel olvassák, osszák meg, és pozitívan fogalmazzák meg az általad írtakat!

Most pedig kész. Menjen el kávézni vagy sétálni - egy blogbejegyzés készítése az elejétől a végéig nem kis teljesítmény. Olvassa el a közösség minden visszajelzését és válaszát, hogy tovább fejlődhessen. És ha van még egy ötleted, akkor csináld újra!

A gyakorlatot nem pótolhatja

A blogbejegyzés írásakor csak öt legfontosabb tennivalónk ment végig, az ötlet felvetésétől a publikálásig. Most, hogy elolvasta, megpróbálja alkalmazni ezt a tanácsot, és megnézheti, mi működik az Ön számára.

Hagyok még egy utolsó tanácsot. A legfontosabb dolog, amit az elmúlt 3 évben megtanultam a blogolásból, hogy abszolút nem tudom megjósolni, hogy milyen tartalom fog levenni, és mi lesz a teljes totál. Néha több napot beteszek egy postába, minden sarkot fényezek, és ez nem megy sehova. Másrészt a „GraphQL vs. REST”, valaha legolvasottabb bejegyzésem, néhány órával késő este íródott.

Tehát akkor is, ha az első, a második vagy a harmadik bejegyzés nem sikerül, próbálkozzon tovább új dolgokkal, tegye ki ötleteit, és idővel javuljon. A világ hallani akarja, mit kell mondania. Menj, mondd el nekik!

Hatalmas köszönet Anvisha Pai-nak, Angela Zhangnak, Katie Siegel-nek és a freeCodeCamp szerkesztőknek, akik segítettek ennek a bejegyzésnek az áttekintésében.