Dự án GraphQL

Trang này chứa thông tin chi tiết về một dự án viết kỹ thuật được chấp nhận cho Phần Google Tài liệu.

Tóm tắt dự án

Tổ chức nguồn mở:
GraphQL
Người viết nội dung kỹ thuật:
carolstran
Tên dự án:
Tạo tài nguyên Câu hỏi thường gặp
Thời lượng dự án:
Thời gian tiêu chuẩn (3 tháng)

Mô tả dự án

Việc tìm hiểu một công nghệ mới chưa bao giờ là việc dễ dàng và đi kèm với rất nhiều câu hỏi. Với GraphQL, dự án đã phát triển đến mức mà hầu hết thông tin đều được cung cấp. Chỉ là tìm thấy nó vì thông tin đó nằm rải rác qua các tài nguyên và cộng đồng lập trình khác nhau.

Một tính năng có thể cải tiến công cụ cho học viên bằng GraphQL sẽ nằm trong phần Câu hỏi thường gặp (FAQ) ở trung tâm. Tính năng này hiện đang bị thiếu trong graphql.org và dẫn đến các câu hỏi liên tục lặp lại hoặc không được trả lời.

Phần Câu hỏi thường gặp mới này sẽ được tích hợp vào trang web của graphql.org và chứa các phần liên quan đến:

  • Lịch sử và nội bộ của GraphQL

    • GraphQL Foundation là gì?
    • GraphQL được tạo ra khi nào và tại sao?
    • Những tài nguyên tốt nhất để bắt đầu là gì?
  • Kiến thức cơ bản về GraphQL

    • Sự khác biệt giữa GraphQL và REST/SQL/v.v. là gì?
    • Các trường hợp sử dụng tốt nhất cho GraphQL là gì?
    • Có phải GraphQL chỉ dành cho nhà phát triển React?
  • Các khái niệm nâng cao về GraphQL

    • Làm cách nào để lưu vào bộ nhớ đệm phía máy chủ bằng GraphQL?
    • GraphQL có hỗ trợ sử dụng ngoại tuyến không?
    • Làm cách nào để kiểm thử API GraphQL?
  • Thông số kỹ thuật

    • Làm cách nào để đóng góp vào thông số kỹ thuật?
    • Cách tốt nhất để tuân thủ các bản phát hành về quy cách là gì?

Và có thể sẽ có nhiều phần khác nữa. Những câu hỏi ở trên có thể là ví dụ. Đó cũng là những câu hỏi mà những đồng nghiệp đang tìm hiểu hoặc sau khi phát biểu tại hội nghị liên quan đến GraphQL đề nghị tôi.

Các câu hỏi cho Câu hỏi thường gặp sẽ được thu thập từ nhiều lĩnh vực trên Internet, sau đó được sắp xếp và ưu tiên. Một số khía cạnh này bao gồm:

  • StackOverflow
  • Các vấn đề về GitHub (trong tổ chức GraphQL, Hướng dẫn về GraphQL và hơn thế nữa)
  • Twitter
  • Trò chuyện với những người hướng dẫn nổi bật của GraphQL
  • Các trang sản phẩm liên quan đến GraphQL
  • Quora

Ngoài nội dung ngắn gọn và hữu ích, chúng tôi sẽ xây dựng trang Câu hỏi thường gặp cuối cùng chú trọng đến trải nghiệm người dùng và khả năng tiếp cận.