LLVM 编译器基础架构项目
本页面包含 Google 文档季接受的技术写作项目的详细信息。
项目摘要
- 开源组织:
- LLVM 编译器基础架构
- 技术文档工程师:
- DR87
- 项目名称:
- 重构 LLVM 文档索引和文档样式指南
- 项目时长:
- 标准时长(3 个月)
Project description
此项目包含以下任务:
a.) 重构了文档索引页,以提供更人性化的体验。这项任务涉及评估当前页面,并综合考虑独立研究、SME 访谈和用户反馈来调整页面结构。可能的方案包括修改简短说明、重构现有页面,以及/或者通过渐进式信息披露模型添加其他层(页面)。后者可减少主索引页上的链接数量,以便用户更轻松地找到特定信息/指南。例如,该索引可能包含指向 LLVM 设计和概览、用户指南、子系统文档和开发流程文档的单独页面的链接。
b.) 更新了面向开源贡献者的 LLVM Sphinx 样式指南。这项任务包括评估现行指南,通过独立研究和 SME 访谈找出不足之处,以及根据商定的要求更新指南。更新可能包括重新整理指南的布局、添加新内容,以及插入指南中相关页面(例如贡献者指南)的链接。最终目标是让志愿者更轻松地尽快开始贡献。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-11-08。
[null,null,["最后更新时间 (UTC):2024-11-08。"],[[["This project aims to improve the LLVM documentation by restructuring its index page for better user experience and updating the style guide to facilitate easier contributions."],["The project involves researching, interviewing subject matter experts, and incorporating user feedback to enhance the organization and accessibility of LLVM documentation."],["Improvements to the documentation index page may include revising descriptions, restructuring content, and implementing a progressive disclosure model for easier navigation."],["Updates to the Sphinx style guide will focus on clarity, comprehensiveness, and providing resources for open-source contributors to quickly get started."],["The project is part of Google Season of Docs and will be completed within a standard timeframe of 3 months by technical writer DR87."]]],["The project aims to improve the LLVM documentation's accessibility and usability. Key actions include restructuring the documentation index page for a better user experience, possibly adding new layers and revising descriptions. Another focus is updating the LLVM Sphinx style guide by identifying gaps, reorganizing the layout, adding new content, and including relevant links to streamline the contribution process for open-source volunteers. The project will involve research, expert interviews, and user feedback.\n"]]