Dự án GraphQL
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này chứa thông tin chi tiết về một dự án viết nội dung kỹ thuật đã được chấp nhận tham gia Google Season of Docs.
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 về 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 học một công nghệ mới không bao giờ dễ dàng và sẽ có rất nhiều câu hỏi. Với GraphQL, dự án đã phát triển đủ để hầu hết thông tin đều có sẵn. Bạn chỉ cần tìm thông tin đó vì thông tin đó nằm rải rác trên nhiều tài nguyên và cộng đồng lập trình.
Một phần có thể cải thiện hiệu quả cho những người mới học GraphQL là phần Câu hỏi thường gặp (FAQ) ở trung tâm. Thông tin này hiện không có trên 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.
Mục Câu hỏi thường gặp mới này sẽ được tích hợp vào trang web graphql.org và chứa các phần liên quan đến:
Nhật ký và nội bộ trong GraphQL
- GraphQL Foundation là gì?
- Tại sao và khi nào thì GraphQL được tạo ra?
- Tài nguyên nào là phù hợp nhất để bắt đầu?
Kiến thức cơ bản về GraphQL
- Điểm khác biệt giữa GraphQL và REST/SQL/v.v. là gì?
- Trường hợp sử dụng tốt nhất cho GraphQL là gì?
- GraphQL chỉ dành cho nhà phát triển React phải không?
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ử GraphQL API?
Thông số kỹ thuật
- Làm cách nào để tôi đóng góp cho quy cách này?
- Cách tốt nhất để theo dõi các bản phát hành thông số kỹ thuật là gì?
Và nhiều phần khác sẽ sớm ra mắt. Các câu hỏi trên là ví dụ tiềm năng. Đây cũng là những câu hỏi mà các đồng nghiệp đang tìm hiểu hoặc sau khi tôi có bài nói chuyện tại hội nghị liên quan đến GraphQL đã hỏi tôi.
Các câu hỏi cho phần Câu hỏi thường gặp sẽ được lấy từ nhiều nơi trên Internet, sau đó được sắp xếp và ưu tiên. Một số lĩnh vực đó bao gồm:
- StackOverflow
- Các vấn đề trên GitHub (trong tổ chức GraphQL, How To GraphQL và các vấn đề khác)
- Twitter
- Cuộc trò chuyện với những người hướng dẫn GraphQL nổi bật
- Trang sản phẩm liên quan đến GraphQL
- Quora
Ngoài nội dung súc tích và hữu ích, trang Câu hỏi thường gặp cuối cùng sẽ được xây dựng theo hướng chú trọng đến trải nghiệm người dùng và khả năng hỗ trợ tiếp cận.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis Google Season of Docs project aims to create a comprehensive FAQ resource for GraphQL learners, centralizing answers to common questions currently scattered across various platforms.\u003c/p\u003e\n"],["\u003cp\u003eThe FAQ section will be integrated into the graphql.org website and will cover topics ranging from GraphQL basics and history to advanced concepts and specification details.\u003c/p\u003e\n"],["\u003cp\u003eQuestions for the FAQ will be sourced from diverse online communities and expert insights, ensuring relevance and practicality for users.\u003c/p\u003e\n"],["\u003cp\u003eThe project will prioritize user experience and accessibility in the design and development of the FAQ page.\u003c/p\u003e\n"]]],["The core project involves creating a centralized FAQ section for GraphQL on graphql.org. The FAQ will address common questions regarding GraphQL's history, basics, advanced concepts, and specification. Content will be sourced from platforms like StackOverflow, GitHub, Twitter, and conversations with experts. The aim is to help new learners find answers to questions that may otherwise go unanswered. This resource will be built to ensure good user experience and accessibility.\n"],null,["# GraphQL project\n\nThis page contains the details of a technical writing project accepted for\nGoogle Season of Docs.\n\n### Project summary\n\nOpen source organization:\n: GraphQL\n\nTechnical writer:\n: carolstran\n\nProject name:\n: Create FAQ resource\n\nProject length:\n: Standard length (3 months)\n\n### Project description\n\nLearning a new technology is never easy - and it comes with a lot of questions. With GraphQL, the project has evolved enough that, for the most part, the information is out there. It's just a matter of finding it because that information is scattered through various resources and programming communities.\n\nSomething that could be an instrumental improvement for GraphQL learners would be a central Frequently Asked Questions (FAQ) section. This is currently missing from graphql.org and leads to questions that are either constantly repeated or left unanswered.\n\nThis new FAQ section will be integrated into the graphql.org website and contain sections related to:\n\n- GraphQL history and internals\n\n - What is the GraphQL Foundation?\n - When and why was GraphQL created?\n - What are the best resources for getting started?\n- GraphQL basics\n\n - What is the difference between GraphQL and REST/SQL/etc?\n - What are the best use cases for GraphQL?\n - Is GraphQL only for React developers?\n- Advanced GraphQL concepts\n\n - How can you do server-side caching with GraphQL?\n - Does GraphQL support offline usage?\n - How can you test your GraphQL API?\n- Specification\n\n - How can I contribute to the specification?\n - What's the best way to follow the specification releases?\n\nAnd likely more sections to come. The above questions are potential examples. They're also all ones that I have been asked by colleagues who are learning or after giving a conference talk related to GraphQL.\n\nThe questions for the FAQ will be sourced through various areas of the Internet and then later sorted and prioritized. Some of these areas include:\n\n- StackOverflow\n- GitHub issues (in the GraphQL organization, How To GraphQL and beyond)\n- Twitter\n- Conversations with prominent GraphQL instructors\n- GraphQL-related product pages\n- Quora\n\nIn addition to succinct and helpful content, the final FAQ page will be built with UX and accessibility in mind."]]
