Projekt GraphQL

Ta strona zawiera szczegółowe informacje na temat projektu dotyczącego pisania technicznego zaakceptowanego do udziału w sezonie 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

Poznawanie nowych technologii nigdy nie jest łatwe 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.

Czymś, co istotnie poprawiłoby jakość pracy osób uczących się w wyniku korzystania z GrafQL, mogłaby znaleźć się centralna sekcja z najczęstszymi pytaniami. Tego rodzaju informacji nie ma obecnie w graphql.org i prowadzi do pytań, które nieustannie powtarzają się lub pozostają bez odpowiedzi.

Ta nowa sekcja z najczęstszymi pytaniami zostanie zintegrowana z witryną Graphql.org i będzie zawierać sekcje dotyczące:

  • Historia GraphQL i dane wewnętrzne

    • Czym jest Fundacja GraphQL?
    • Kiedy i dlaczego utworzono GraphQL?
    • Jakie zasoby są najlepsze na początek?
  • Podstawy GraphQL

    • Czym różni się GraphQL od REST/SQL itp.?
    • Jakie są najlepsze przypadki użycia GraphQL?
    • Czy GraphQL jest tylko dla programistów React?
  • Zaawansowane koncepcje związane z GraphQL

    • Jak za pomocą GraphQL ustawić 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 ulepszaniu specyfikacji?
    • Jaki jest najlepszy sposób postępowania zgodnie z opublikowanymi specyfikacjami?

Prawdopodobnie wkrótce pojawi się więcej sekcji. Pytania powyżej to potencjalne przykłady. Spytali mnie też koledzy, którzy się uczą lub wygłosili po konferencji na temat GraphQL.

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

  • StackOverflow
  • problemy z GitHub (w organizacji GraphQL, poradami dotyczącymi GraphQL i nie tylko)
  • Twitter
  • Rozmowy z najlepszymi instruktorami GraphQL
  • Strony produktów związane z GraphQL
  • Quora

Oprócz zwięzłych i pomocnych treści ostateczna strona z najczęstszymi pytaniami będzie stworzona z myślą o wygodzie użytkowników i ułatwieniach dostępu.