Progetto GraphQL

Questa pagina contiene i dettagli di un progetto di scrittura tecnica accettato per la stagione dei documenti Google.

Riepilogo del progetto

Organizzazione open source:
GraphQL
Technical writer:
carolstran
Nome progetto:
Crea una risorsa Domande frequenti
Durata del progetto:
Durata standard (3 mesi)

Project description

Imparare una nuova tecnologia non è mai facile e comporta moltissime domande. Con GraphQL, il progetto si è evoluto talmente che, nella maggior parte dei casi, le informazioni sono disponibili pubblicamente. Si tratta solo di trovarla perché le informazioni sono sparse attraverso varie risorse e comunità di programmazione.

Una sezione centrale delle Domande frequenti è una sezione che potrebbe rivelarsi un miglioramento strumentale per gli studenti di GraphQL. Al momento questo aspetto non è presente su Graphql.org e porta a domande che vengono costantemente ripetute o non ricevono risposta.

Questa nuova sezione delle Domande frequenti (FAQ) verrà integrata nel sito web di Graphql.org e conterrà sezioni relative a:

  • Cronologia e dati interni di GraphQL

    • Che cos'è GraphQL Foundation?
    • Quando e perché è stato creato GraphQL?
    • Quali sono le risorse migliori per iniziare?

  • Nozioni di base su GraphQL

    • Qual è la differenza tra GraphQL e REST/SQL e così via?
    • Quali sono i casi d'uso migliori per GraphQL?
    • GraphQL è riservato solo agli sviluppatori React?

  • Concetti avanzati di GraphQL

    • Come si può eseguire la memorizzazione nella cache lato server con GraphQL?
    • GraphQL supporta l'utilizzo offline?
    • Come si può testare l'API GraphQL?

  • Specifiche

    • Come posso contribuire alla specifica?
    • Qual è il modo migliore per seguire le release delle specifiche?

E probabilmente verranno aggiunte altre sezioni. Le domande riportate sopra sono potenziali esempi. Sono tutte domande che mi sono state poste dai colleghi che stanno studiando o dopo aver tenuto una conferenza su GraphQL.

Le domande delle Domande frequenti (FAQ) verranno ordinate in diverse aree di Internet e successivamente ordinate e ordinate in base alla priorità. Ecco alcune di queste aree:

  • StackOverflow
  • Problemi relativi a GitHub (nell'organizzazione GraphQL, How To GraphQL e oltre)
  • Twitter
  • Conversazioni con importanti istruttori di GraphQL
  • Pagine dei prodotti correlate a GraphQL
  • Quora

Oltre a contenuti brevi e utili, l'ultima pagina delle domande frequenti verrà sviluppata tenendo conto dell'esperienza utente e dell'accessibilità.