Esta página contiene los detalles de un proyecto de redacción técnica aceptado para la temporada de Documentos de Google.
Resumen del proyecto
- Organización de código abierto:
- GraphQL
- Escritor técnico:
- carolstra
- Nombre del proyecto:
- Crea un recurso de preguntas frecuentes
- Duración del proyecto:
- Duración estándar (3 meses)
Project description
Aprender a usar una nueva tecnología nunca es fácil y acarrea muchas preguntas. Con GraphQL, el proyecto ha evolucionado lo suficiente como para que, en su mayor parte, la información esté disponible. Es cuestión de encontrarlos, ya que la información está dispersa por diversos recursos y comunidades de programación.
Una sección central de Preguntas frecuentes (FAQ) podría ser una mejora fundamental para los alumnos de GraphQL. Esta información no se encuentra en grafoql.org y conduce a preguntas que se repiten constantemente o no se responden.
Esta nueva sección de Preguntas frecuentes se integrará en el sitio web de grafoql.org y contendrá secciones relacionadas con lo siguiente:
Historial y elementos internos de GraphQL
- ¿Qué es GraphQL Foundation?
- ¿Cuándo y por qué se creó GraphQL?
- ¿Cuáles son los mejores recursos para empezar?
Conceptos básicos de GraphQL
- ¿Cuál es la diferencia entre GraphQL y REST/SQL/etcétera?
- ¿Cuáles son los mejores casos de uso de GraphQL?
- ¿GraphQL es solo para desarrolladores de React?
Conceptos avanzados de GraphQL
- ¿Cómo puedes realizar el almacenamiento en caché del servidor con GraphQL?
- ¿GraphQL admite el uso sin conexión?
- ¿Cómo puedes probar tu API de GraphQL?
Especificación
- ¿Cómo puedo contribuir a la especificación?
- ¿Cuál es la mejor manera de seguir las versiones de especificaciones?
Y probablemente más secciones vendrán. Las preguntas anteriores son ejemplos posibles. También son todas aquellas preguntas que me pidieron los colegas que están aprendiendo o después de dar una charla sobre GraphQL.
Las preguntas de las Preguntas frecuentes se obtendrán de varias áreas de Internet y luego se clasificarán y priorizarán. Estas son algunas de estas áreas:
- StackOverflow
- Problemas de GitHub (en la organización de GraphQL, How To GraphQL y otros)
- Conversaciones con instructores destacados de GraphQL
- Páginas de productos relacionadas con GraphQL
- Quora
Además del contenido breve y útil, la página final de Preguntas frecuentes se diseñará teniendo en cuenta la UX y la accesibilidad.