Obecny etap:
Ogłoszenie wyników Oś czasu.
Ta strona zawiera wskazówki dla organizacji open source, które pomogą im ocenić i wybrać odpowiedniego autora projektu dotyczącego projektu Season of Docs.
Wstęp
Organizacje open source muszą zatrudnić redaktora technicznego do pracy nad proponowanym projektem. Organizacje muszą mieć własnego autora tekstu technicznego. Autorów treści technicznych zainteresowanych współpracą z organizacjami uczestniczącymi w sezonie dokumentów można znaleźć w repozytorium Sezon of Docs na GitHubie oraz na kanale#SEASON-of-docs na stronie Zapisuj dokumenty.
Rozpoczęcie procesu
Warto jak najszybciej rozpocząć proces znajdowania redaktora technicznego, gdy uznasz, że zechcesz wziąć udział w programie Sezon Dokumentów.
Ocena autora technicznego
Zalecamy, aby poprosić autorów rozważnych o przykłady poprzednio opracowanej dokumentacji technicznej. Umożliwi to ocenę ich technicznych umiejętności pisania i doświadczenia.
Umiejętności i doświadczenie techniczne
Zapoznaj się z doświadczeniem autora tekstu technicznego. Najlepiej, gdyby pisarz techniczny miał doświadczenie w pisaniu dokumentacji technicznej dla branży oprogramowania. Jednym z celów programu Season of Docs jest umożliwienie autorom treści technicznych poświęconych produktom i usługom. Dlatego nawet jeśli projekt koncentruje się na odbiorcach, nie jest konieczne, aby twórca miał doświadczenie w korzystaniu z interfejsów API, pakietów SDK czy innych platform programistycznych.
Skup się na umiejętnościach językowych i komunikacyjnych. Z tego punktu widzenia należy ocenić wcześniejsze prace redaktora technicznego. Najważniejsze: czy potrafisz zrozumieć, co napisała ta osoba? Jeśli chcesz dokładnie zrecenzować język pracy autora technicznego, musisz zadbać o spójność w zakresie interpunkcji i sformułowań, poprawną pisownię i jasny język. Czy sformułowanie jest proste czy skomplikowane? Czy zdania są krótkie czy dłużą się, aż staną się trudne do zrozumienia?
Zwróć uwagę na projekt i układ dokumentów. Sprawdź ogólny układ przykładowych dokumentów. Czy projekt jest logiczny? Czy łatwo jest poruszać się po dokumencie lub zbiorze dokumentacji? Czy występują powielone treści czy jakieś oczywiste luki?
Zatrudnienie autora tekstu technicznego
Organizacje muszą zatrudnić redaktora technicznego i wypełnić formularz rekrutacji dla pisarzy technicznych, do którego link znajduje się poniżej, do 16 maja 2022 r. do godz. 18:00 czasu UTC.
Etap zatrudnienia pisarzy technicznych został ukończony.
Przed zatrudnieniem należy omówić ze specjalistą ds. technicznych wynagrodzenia oraz harmonogram płatności. Zalecamy organizacjom ustanowienie harmonogramu płatności wspólnie z autorami technicznymi na podstawie etapów projektu, w tym płatności na początku projektu. Podczas tworzenia harmonogramu płatności pamiętaj o datach płatności, które zostaną zrealizowane tylko dwa razy w ramach programu, oraz o kwotach.
Uwaga: organizacje, które nie zatrudniły pisarza technicznego i do 16 maja 2022 r. do godz. 18:00 czasu UTC przesłały formularz zatrudnienia pisarza technicznego, nie otrzymają środków w pierwszym dniu wypłaty środków.