Projekt GraphQL

Ta strona zawiera szczegółowe informacje na temat projektu technicznego przyjęta do programu Sezon Dokumentów Google.

Podsumowanie projektu

Organizacja open source:
GraphQL
Pisarz techniczny:
carolstran
Nazwa projektu:
Utwórz zasoby z najczęstszymi pytaniami
Długość projektu:
Standardowa długość (3 miesiące)

Opis projektu

Nauka nowej technologii nigdy nie jest łatwa i wiąże się z wieloma pytaniami. Dzięki GraphQL projekt rozwinął się na tyle, że w większości przypadków informacje są dostępne. Chodzi tylko o znalezienie tych informacji, ponieważ są one rozrzucone w różnych zasobach i społecznościach programistycznych.

Jedną z rzeczy, które mogą w znacznym stopniu pomóc poprawić umiejętności osób uczących się w zakresie GraphQL, może być główna sekcja z najczęstszymi pytaniami. Tego rodzaju pytania nie ma obecnie w graphql.org, dlatego prowadzą do pytań, które są ciągle powtarzane lub pozostają bez odpowiedzi.

Nowa sekcja z najczęstszymi pytaniami zostanie zintegrowana z witryną Graphql.org i będzie zawierać sekcje dotyczące następujących zagadnień:

  • Historia GraphQL i dane wewnętrzne

    • Czym jest Fundacja GraphQL?
    • Kiedy i dlaczego powstał GraphQL?
    • Jakie materiały pomogą Ci zacząć?
  • Podstawy GraphQL

    • Jaka jest różnica między GraphQL a REST/SQL itp.?
    • Jakie są najlepsze przypadki użycia GraphQL?
    • Czy narzędzie GraphQL jest przeznaczone tylko dla programistów React?
  • Zaawansowane koncepcje GraphQL

    • Jak za pomocą GraphQL można zastosować buforowanie po stronie serwera?
    • Czy GraphQL obsługuje korzystanie w trybie offline?
    • Jak możesz przetestować interfejs GraphQL API?
  • Specyfikacja

    • Jak mogę pomóc w rozwijaniu specyfikacji?
    • Jak najlepiej zachować zgodność z opublikowanymi specyfikacjami?

Wkrótce pojawi się więcej sekcji. Podane wyżej pytania to potencjalne przykłady. Spytali mnie też koledzy, którzy się uczą lub po wygłoszeniu konferencji na temat GraphQL.

Pytania do najczęstszych pytań są pobierane z różnych miejsc w internecie, a następnie posortowane i uporządkowane według priorytetów. Są to między innymi:

  • StackOverflow
  • Problemy z GitHubem (w organizacji GraphQL, How To GraphQL i poza nią)
  • Twitter
  • Rozmowy z wybitnymi instruktorami korzystającymi z GrafQL
  • Strony produktów związane z GraphQL
  • Quora

Oprócz zwięzłych i przydatnych treści ostateczna strona z najczęstszymi pytaniami będzie przyjazna dla użytkowników i przydatna.