Zasady pisania artykułów

Cześć! Jeśli tu trafiłeś oznacza to, że chcesz podzielić się wiedzą z angularowym community! Dowiesz się tutaj między innymi jak przebiega proces publikacji artykułu - od pomysłu, aż do udostępnienia gotowego artykułu.

W każdym kroku możesz zgłosić się do nas o wsparcie i konsultacje. Pierwszą rzeczą będzie dołączenie do naszej grupy na Discord angular.love bloggers gdzie zrzeszamy wszystkich blogerów i wspólnie się komunikujemy

1

Pomysł

  • Temat - jeśli nie masz jeszcze wizji na to co chcesz napisać, możesz skonsultować się z nami (na grupie na Discord)

  • Jeśli zastanawiasz się nad formą w jakiej ująć dany temat, oto kilka propozycji:

    • Wskazówki (co robić lub czego nie robić)

      • „5 sposobów na… ..”

      • Tego rodzaju artykuły są szybkie do przeczytania. Niektórzy czytają je tylko za pomocą nagłówków, a potem czytają, jeśli znajdą interesującą wskazówkę. Musi być dobrze zorganizowany, podzielony i zawierać wiele konkretnych faktów.

    • Poradniki

      • Coś w rodzaju N Tips, ale krok po kroku i bardziej precyzyjne instrukcje. Przykładowo jak krok po kroku użyć jakiejś biblioteki.

    • Temat Kontrowersyjny

      • Ponieważ kontrowersje są bardzo emocjonalne, musisz być ostrożny i mądrze dobierać słowa. W tego typu postach tytuł powinien być kluczowym punktem zainteresowania odbiorców.

    • Listy Kontrolne

      • Czy masz wszystko, czego potrzebujesz do ____?

      • Coś w rodzaju poradników, ale utworzonych jako zawartość listy kontrolnej.

    • Opinie

      • Ludzie szukają recenzji przed użyciem czegoś. Możesz napisać np. recenzję jakiejś biblioteki, książki, produktu itd.

    • Aktualności

      • Wiadomości, zarówno oryginalne, jak i opiniotwórcze, są korzystne, ponieważ dostarczają czytelnikom nieprzetworzone, aktualne informacje. Mogą to być wiadomości dotyczące konferencji, udostępnienia technologii, ważnych kontaktów itp.

    • Wywiad

      • Odegrasz tutaj rolę dziennikarza, który zadaje jakieś pytania jednemu z ekspertów w swoim temacie. Wywiad musi być autoryzowany przez osobę przesłuchiwaną. Struktura powinna składać się z pytania, kilku zdań odpowiedzi, następnego pytania itd.

    • Krótka historia/studium przypadku

      • Ten typ artykułu powinien potwierdzać niektóre fakty lub wiedzę specjalistyczną w oparciu o pewne studium przypadku – prawdziwy projekt, który wykonałeś lub rzeczywistą sytuację, którą miałeś. Inną historią może być dzielenie się Twoim sukcesem, gdy zakończyłeś jakiś duży projekt, który znajduje się obecnie w fazie produkcji i jakie po drodze były wyzwania technologiczne i nie tylko.

    • Tips & Tricks

      • Ten typ artykułów jest osobny. Ma to na celu przekazanie czytelnikowi bardziej skondensowanej wiedzy na temat najpopularniejszych tematów w obszarze zainteresowania. Powinien koncentrować się na tematach, które potencjalnie mogą stanowić wyzwanie dla czytelników lub nawet nie wiedzą, że jest to wyzwanie, ale wiemy, że znamy tam naprawdę dobrą praktykę i chcemy się z nimi podzielić wiedzą na ten temat. Powinno to być coś w rodzaju artykułów na Stackoverlow, na przykład 2-3 najlepsze odpowiedzi razem.

2

Research Tematu

  • Sprawdź czy istnieją już inne artykuły na podobny temat na angular.love. Jeśli tak (a jest ich sporo, więc szansa jest duża), nic nie szkodzi - tak długo jak twój artykuł rzuca na dany temat nowe światło, wciąż warto go napisać! Ale pamiętaj! Bardzo ważne jest dla nas aby content na naszym blogu był możliwie oryginalny.

  • Nie możemy opublikować Twojego artykułu który został wcześniej opublikowany w innym miejscu

3

Konspekt

  • Mając wiedzę o tym co już znajduje się na blogu, spróbuj naszkicować plan na artykuł - zaproponuj tytuł (w miarę możliwości chwytliwy), wstępnie wypisz z jakich akapitów będzie się składał, zastanów się do jakiej grupy zaawansowania jest kierowany (jakiej wiedzy potrzebuje czytelnik do jego zrozumienia, dlaczego temat może być ważny dla naszych czytelników)

  • Podziel się konspektem z innymi bloggerami na grupie angular.love bloggers. Dopracowanie konspektu bardzo pomoże ci w pisaniu i sprawi że efekt końcowy będzie wysokiej jakości! A wkład innych w tym procesie jest nieoceniony!

  • Po uwzględnieniu uwag innych autorów czas przejść do właściwego pisania.

4

Praca nad artykułem

  • Pisząc artykuł, warto uwzględnić następujące zasady:

    • Przejrzysta struktura artykułu

      • Podziel artykuł na wstęp, rozwinięcie i podsumowanie

      • Stosuj nagłówki

      • Dziel tekst na akapity

    • W ramach możliwości użyj interaktywnego przykładu, np. na stackblitz

    • Snipetty kodu powinny być wstawiane jako code block

      • Żeby łatwo je dodawać należy włączyć formatowanie markdown (Use Markdown in Google Docs, Slides, & Drawings) i wpisać ``` + enter

    • Staraj się aby kod użyty w przykładach wykorzystywał najnowsze standardy w angularze, takie jak:

      • Standalone komponenty

      • Inject function

      • Sygnały

    • W miarę możliwości wzbogać swój artykuł o grafiki, uwzględniając to żeby były one czytelne i dobrej jakości

  • Pamiętaj, że na każdym etapie prac, społeczność bloggerów jest do twojej dyspozycji!

5

Review końcowe

  • Gdy jesteś usatysfakcjonowany treścią swojego artykułu, udostępnij go na grupie angular.love.bloggers, tak, żeby inni autorzy mogli poddać go recenzji

  • Odnieś się do uwag i daj znać w komentarzu gdy wprowadzisz poprawki

6

Tłumaczenie artykułu

  • Jak zapewne wiesz nasz blog jest prowadzony w dwóch językach Polskim i Angielskim. Jeżeli napisałeś artykuł po Angielsku trzeba będzie go przetłumaczyć na język Polski. (Podobnie w drugą stronę :))

  • Jeżeli nie znasz języka polskiego - nic się nie martw przetłumaczymy go za Ciebie!

7

Publikacja

  • Teraz my zajmiemy się przeniesieniem twojego artykułu do CMS’a i zaplanujemy jego opublikowanie

  • Zajmiemy się również jego promowaniem w mediach społecznościowych, aby jak najwięcej osób mogło skorzystać z wiedzy, którą w nim zawarłeś!

Tak wygląda proces pisania przez Ciebie artykułu :)

Masz jakieś pytania? Skontaktuj się z nami.

angular@angular.love