Jak pisać o językach programowania bez zaplecza technicznego?

Wprowadzenie

Pisanie zawsze było moją pasją. Kiedy dostałem pracę jako pisarz Web3 dla firmy ed-tech, byłem w siódmym niebie. Według Social Media Today, 77% użytkowników Internetu czyta blogi. Tak więc moja praca była okazją do zaprezentowania światu mojej pracy.

Podczas gdy marzyłem o tym, jak będę miał lojalną publiczność i międzynarodowe grono czytelników w ciągu najbliższych kilku miesięcy, zostałem poproszony przez mojego menedżera o napisanie przewodników po różnych językach programowania, które są często używane w przestrzeni Web3. Pochodząc z nietechnicznego środowiska, wydawało mi się to trudnym zadaniem.

Jednak po wielu próbach i błędach w końcu doszedłem do punktu, w którym opracowałem przepis na pisanie długich przewodników po różnych językach programowania, a także w sposób, w jaki pisałaby osoba z wykształceniem technicznym.

Dlatego na tym blogu podzielę się pięcioma wskazówkami, które pozwoliły mi zaoszczędzić energię i czas oraz pomogły mi w pisaniu technicznych i poprawnych merytorycznie poradników, które mogą pozycjonować się w Google.

(Zdjęcie wykonane przez Metaschool)

Dlaczego warto pisać poradniki na tematy techniczne?

Zanim ten poradnik przejdzie do formuły, pozwól nam najpierw zrozumieć, dlaczego pisanie poradników na tematy techniczne jest ważne i może przynieść dobre wyniki dla twojego bloga.

Po pierwsze, poradniki techniczne to świetny sposób na nawiązanie kontaktu z odbiorcami, dzielenie się swoją wiedzą i umiejętnościami. Jednak treści techniczne są również bardzo niszowe. Raczej nie będziesz pisać takich poradników, jeśli prowadzisz blog lifestylowy. Jednak wraz z rozwojem nowych technologii, takich jak sztuczna inteligencja i blockchain, blogi związane z technologią zyskują na popularności. Wiele z nich ma własne produkty oparte na sztucznej inteligencji. W tym przypadku pisanie techniczne może odegrać ogromną rolę w kierowaniu ruchu na bloga i produkt.

Po drugie, nie ma wątpliwości, że w dzisiejszych czasach, gdy chcesz nauczyć się czegoś technicznego, YouTube jest miejscem, do którego możesz się udać. Dostępne są setki tysięcy filmów i samouczków. Przestrzeń jest dość nasycona. Możesz się teraz zastanawiać, że skoro wymagany materiał jest już dostępny na YouTube, dlaczego ktoś miałby uciekać się do pisania długich przewodników? Cóż, to jest właśnie twoja odpowiedź. Wszyscy wokół ciebie myślą mniej więcej w ten sam sposób. Ludzie koncentrują się na tworzeniu coraz większej ilości treści wideo, nie zdając sobie sprawy, że mogą również budować publiczność, pisząc treści.

Po trzecie, jeśli mówimy o językach programowania, to w Internecie nie ma zbyt wielu pisemnych przewodników. Dokumentacja dostępna na oficjalnych stronach internetowych jest zwykle obszerna i zawiera wiele informacji. Przewodniki zasadniczo konsolidują wszystkie dostępne informacje zawarte w długiej dokumentacji języka, podsumowują je i udostępniają mniej zagmatwaną, łatwą w nawigacji wersję, aby zaspokoić potrzeby odbiorców, którzy wolą czytać.

Wreszcie, aby powtórzyć, jeśli masz firmę, która obraca się wokół technologii, Web3 i sztucznej inteligencji, pisanie przewodników jest najszybszym sposobem, aby pomóc Ci w rankingu dla różnych słów kluczowych i wyprowadzić Twoją firmę na pierwszy plan. Oto niektóre z powodów, dla których powinieneś rozważyć pisanie poradników na tematy techniczne, jeśli masz bloga lub firmę w podobnej niszy.

Wskazówka #1 - Mądrze wybieraj języki, w których chcesz pisać swoje przewodniki.

Pierwszym krokiem jest mądre postępowanie, ponieważ nie chcesz pisać przewodnika na temat języka, takiego jak Solidity, który jest już trudny do pozycjonowania. Dlatego też należy rozpocząć od dokładnego zbadania słów kluczowych przed rozpoczęciem pisania przewodników na temat danego języka. Magiczna formuła dla słów kluczowych o niskim nakładzie pracy to: wysoka liczba wyszukiwań i niski poziom trudności. W tym celu można skorzystać z wyszukiwarki słów kluczowych Ranktracker. Możesz również sprawdzić liczbę pełnometrażowych przewodników, które zostały już opublikowane, aby poznać swoją konkurencję. W rzeczywistości, aby ocenić swoich konkurentów, możesz skorzystać z narzędzia SERP Checker Ranktrackera, które pomoże Ci skonsolidować słabe punkty konkurencji.

Zanim jednak wybierzesz podstawowe i drugorzędne słowa kluczowe, upewnij się, że język, o którym piszesz, nie staje się przestarzały ani nie przechodzi żadnych poważnych zmian. Czasami może się zdarzyć, że znajdziesz idealne słowo kluczowe do napisania przewodnika językowego tylko po to, aby zdać sobie sprawę, że nazwa języka uległa zmianie, np. kair jest teraz kair 1.0. Narzędzia takie jak Ahrefs nie pokażą ci tego od razu.

Jeśli język został już zmieniony, będzie to widoczne. Ale w niektórych przypadkach język może nadal znajdować się na etapie proponowania zmian. Dlatego też bardzo ważne jest odrobienie obszernej pracy domowej na temat tego, co język zamierza zrobić w przyszłości.

Wskazówka #2 - Bądź bardzo konkretny w kwestii konspektu przewodnika

Konspekt jest wszystkim podczas pisania długich poradników językowych. Jednak tworzenie konspektów jest również jednym z najtrudniejszych zadań. Pisząc poradniki dla szerszej publiczności, należy kierować się pewną zasadą: nie można być zbyt prostym i zbyt technicznym. Zawsze należy zachować równowagę między jednym i drugim.

Oznacza to, że zarówno początkujący programista, jak i ekspert powinni być w stanie zrozumieć i uchwycić to, co mówisz. A konspekt bardzo pomaga w tym przypadku. Teraz równie ważne jest spełnienie intencji wyszukiwarki i odpowiednie przygotowanie treści.

Z mojego doświadczenia wynika, że gdy ludzie szukają przewodników po językach, zazwyczaj szukają praktycznej wiedzy. W związku z tym twój zarys powinien być bardziej skoncentrowany na praktycznej nauce, a mniej na wiedzy ogólnej, takiej jak historia języka programowania.

(Obraz zaczerpnięty z Sulekha)

Wskazówka #3 - Zacznij przewodnik od mniej złożonych rzeczy

Kiedy w końcu zaczniesz pisać przewodnik po języku, upewnij się, że zaczynasz od podstawowych rzeczy, a następnie zwiększasz złożoność w miarę postępów. Jeśli piszesz o języku takim jak Python, krótko i zwięźle przedstaw go od samego początku. Zanotuj wszystkie ważne i zabawne fakty na temat języka i zacznij rozsypywać je na początku. Aby przyciągnąć czytelnika do bloga, zaleca się dodanie statystyk, takich jak odsetek osób używających tego języka itp. Można również pomyśleć o tym jako o odpowiedzi na pytania "kto", "kiedy" i "dlaczego" danego języka.

Następnie należy wspomnieć o niektórych popularnych projektach, które zostały zakodowane przy użyciu tego konkretnego języka programowania. W wielu przypadkach ludzie nie są świadomi, że aplikacja, z której korzystają na co dzień, jest częściowo lub w pełni zakodowana w określonym języku programowania. To sprawia, że są zaintrygowani i zaciekawieni i czytają dalej. W rzeczywistości wspominanie o tych zabawnych faktach od czasu do czasu w przewodniku sprawia, że jest on bardziej przystępny dla mniej doświadczonych programistów.

Można również rozważyć porównanie głównego języka z jego konkurentem. Dzięki temu czytelnik zyska nową perspektywę. Podsumowując, postaraj się poświęcić pierwsze 500-600 słów na wprowadzenie języka. Postaraj się jednak nie przekraczać tego limitu.

Wskazówka #4 - Skoncentruj się na mięsistej części przewodnika

Jak wspomniano, osoby szukające pisemnych przewodników online szukają praktycznych wskazówek i specyfiki języka. Czytając dokumentację języka programowania, można również zauważyć pewien wzorzec. Niektóre rzeczy są stałe we wszystkich z nich. Należą do nich typy danych, typy zmiennych, frameworki, biblioteki, narzędzia itp.

Pokazuje to, że nie można iść na kompromis i zawsze należy o tym wspomnieć. Podczas gdy każdy język programowania ma wiele różnych frameworków, bibliotek i narzędzi, powinieneś wybrać 3 popularne elementy dla każdego z nich i dodać je. Oficjalne konta GitHub języków mogą w tym znacznie pomóc.

Teraz możesz się zastanawiać, że skoro te szczegóły są już dostępne na GitHub, dlaczego miałbyś dodawać je do swojego przewodnika? Cóż, informacje na GitHub są trudne w nawigacji, ponieważ zawierają setki plików. Tak więc skupienie się na ważnych fragmentach będzie bardzo pomocne, ponieważ wypełnisz lukę, szybko dostarczając czytelnikom 3 najlepsze biblioteki, frameworki, narzędzia itp. Co więcej, czytelnicy będą mogli również w pełni wykorzystać przewodnik.

Wskazówka #5 - Podwójna część nauki

Po rozpoczęciu pisania głównej części przewodnika, która zawiera szczegóły językowe, należy upewnić się, że zapewniasz czytelnikowi wartość poprzez praktyczne zastosowanie tego, co napisałeś.

Większość przewodników dostępnych obecnie w Internecie nie obejmuje kodowania. Pochodząc ze środowiska nietechnicznego, nie byłbyś również świadomy kodowania. Jednak wspomnienie o podstawowych krokach kodowania w artykule, zwłaszcza przy użyciu frameworków i bibliotek oraz narzędzi, o których wspomniałeś, może sprawić, że Twój przewodnik będzie bardziej wartościowy.

Ale jak możesz kodować, jeśli nic o tym nie wiesz? W tym miejscu możesz skorzystać z pomocy Bard, ChatGPT lub Ranktracker's AI Article Writer, które pomogą Ci, powiedzmy, zakodować najprostszy inteligentny kontrakt w 3 prostych krokach. Możesz zlecić jego sprawdzenie znajomemu programiście lub opublikować go na forum dla programistów, aby upewnić się, że to, co napisałeś, jest poprawne.

Zwiększy to Twoją autentyczność i autorytet jako właściciela bloga lub pisarza.

Podsumowując,

Pisanie długich przewodników technicznych nie jest łatwym zadaniem, zwłaszcza gdy nie ma się dużej wiedzy na temat żargonu programistycznego. Pojawi się wiele wyzwań. Jednak po napisaniu pierwszych 2-3 przewodników po języku programowania, będziesz w stanie opanować rzeczy. To działa jako proces. Chociaż powyższe wskazówki mogą nie być najdokładniejszą formułą pisania przewodników po językach programowania, z pewnością mogą pomóc w dostosowaniu i dodaniu struktury do przewodników jako osoba nienależąca do środowiska technicznego.