Ta strona zawiera szczegółowe informacje o projekcie polegającym na pisaniu tekstów technicznych, który został zaakceptowany w ramach Google Season of Docs.
Podsumowanie projektu
- Organizacja open source:
- GraphQL
- Pisarz techniczny:
- karolstran
- Nazwa projektu:
- Tworzenie zasobu z odpowiedziami na najczęstsze pytania
- Długość projektu:
- Standardowa długość (3 miesiące)
Opis projektu
Nauka nowej technologii nigdy nie jest łatwa – wiąże się z wiele pytań. Dzięki GraphQL projekt ewoluował na tyle, że większość informacji jest już dostępna. Wystarczy je znaleźć, ponieważ są one rozproszone w różnych zasobach i społecznościach programistycznych.
Coś, co mogłoby być przydatne dla osób uczących się GraphQL, to sekcja z odpowiedziami na najczęstsze pytania. Obecnie na stronie graphql.org nie ma takich informacji, co prowadzi do powtarzających się pytań lub braku odpowiedzi na nie.
Ta nowa sekcja odpowiedzi na najczęstsze pytania zostanie zintegrowana z witryną graphql.org i będzie zawierać sekcje dotyczące:
Historia i wewnętrzne dane GraphQL
- Czym jest Fundacja GraphQL?
- Kiedy i dlaczego powstał GraphQL?
- Jakie są najlepsze materiały dla początkujących?
Podstawowe informacje o GraphQL
- Jaka jest różnica między GraphQL a REST/SQL itd?
- Jakie są najlepsze zastosowania GraphQL?
- Czy GraphQL jest przeznaczony tylko dla programistów React?
Zaawansowane zagadnienia związane z GraphQL
- Jak korzystać z buforowania po stronie serwera w przypadku GraphQL?
- Czy GraphQL obsługuje tryb offline?
- Jak przetestować interfejs GraphQL API?
Specyfikacja
- Jak mogę przyczynić się do opracowania specyfikacji?
- Jak najlepiej zachować zgodność ze zmianami w specyfikacji?
Prawdopodobnie pojawią się też inne sekcje. Powyższe pytania to przykłady. To także wszystkie pytania od kolegów i koleżanek, którzy się uczą lub po wygłoszeniu konferencji na temat GraphQL.
Pytania do najczęstszych pytań zostaną zebrane z różnych obszarów internetu, a potem posortowane według priorytetów. Oto niektóre z nich:
- StackOverflow
- problemy na GitHubie (w organizacji GraphQL, w sekcji „How To GraphQL” i innych);
- rozmowy z czołowymi instruktorami GraphQL,
- Strony usług związanych z GraphQL
- Quora
Oprócz zwięzłych i przydatnych treści ostateczna strona z najczęstszymi pytaniami będzie zaprojektowana z uwzględnieniem interfejsu użytkownika i dostępności.