$ cat zasady-redakcyjne.md
Zasady redakcyjne
Chcemy, żeby każdy przewodnik był rzetelny, aktualny i zrozumiały dla osoby, która dopiero zaczyna. Oto zasady, którymi kierujemy się przy pisaniu.
Ostatnia aktualizacja:
Jak wybieramy tematy
Tematy pochodzą głównie od czytelników: z pytań zadawanych podczas warsztatów, wiadomości e-mail i komentarzy. Priorytet mają zagadnienia, na których początkujący najczęściej utykają, a nie te, które są akurat modne.
Weryfikacja treści i kodu
Każdy przykład kodu jest uruchamiany przed publikacją w aktualnych wersjach popularnych przeglądarek. Artykuł przechodzi przez recenzję drugiej osoby z zespołu, która sprawdza poprawność merytoryczną, język i dostępność. Tam, gdzie to możliwe, odwołujemy się do oficjalnej dokumentacji, na przykład MDN Web Docs czy dokumentacji Gita.
Aktualizacje
Technologie szybko się zmieniają, dlatego przeglądamy każdy przewodnik co najmniej dwa razy w roku. Data ostatniej aktualizacji jest widoczna pod tytułem artykułu. Istotne zmiany merytoryczne opisujemy w treści.
Niezależność
Nie publikujemy artykułów sponsorowanych ani linków afiliacyjnych. Nie przyjmujemy wynagrodzenia za wzmianki o kursach, narzędziach czy szkołach programowania. Jeśli kiedykolwiek to się zmieni, każda taka treść zostanie wyraźnie oznaczona.
Oceny artykułów
Ocena widoczna przy artykule to średnia ocen czytelników zbieranych w ankietach newslettera w skali od 1 do 10. Nie wpływa ona na treść przewodnika, ale pomaga nam zdecydować, które teksty rozbudować.
Zdrowie i bezpieczeństwo
Teksty o zdrowiu przy pracy z komputerem mają charakter informacyjny i nie zastępują porady lekarza, fizjoterapeuty ani psychologa. Konsultujemy je z osobami z odpowiednim wykształceniem.
Zgłaszanie błędów
Znalazłeś błąd, nieaktualną informację lub niedziałający przykład? Napisz na [email protected] albo skorzystaj z formularza kontaktowego. Poprawki wprowadzamy zwykle w ciągu tygodnia.