本页面包含“Google 文档季”接受的技术写作项目的详细信息。
项目摘要
- 开源组织:
- SymPy
- 技术文档工程师:
- 苏米 7
- 项目名称:
- 文档字符串之间的一致性 - Sympy 文档
- 项目时长:
- 标准时长(3 个月)
Project description
摘要:
Sympy 文档和之前工作的现状:
已完成为 SymPy 创建官方样式指南的工作。
Lauren Glattly 的 GSoD 项目为 SymPy 文档字符串创建了一份样式指南,您可以在“SymPy 文档样式指南”中找到该指南。
对 Special 子模块和 resolvers.py 文件中的文档字符串进行了编辑,以始终遵循新样式指南的准则
代码库中的所有其他文档字符串仍需根据新的样式指南进行修改。
建议的工作:
SymPy 中的大多数文档字符串仍然不遵循最新的样式指南。此项目的目标是更新整个 SymPy 的文档字符串,以遵循本指南。
我与导师讨论了该项目。这是指向该讨论的链接。
他们决定,在 sympy 的整个代码库中修改文档字符串以遵循最新样式指南是一项重大任务,该项目应仅限于此。
我参与该项目的工作涉及到实施新指南来更新现有文档字符串,同时收集并解决其他不一致问题,例如语言使用或术语。
现有子部分的顺序可在以后更改或确定,也可以作为单独的任务进行更改。
通过添加更多示例和添加参数部分,展示向参数传递不同值时结果的差异。
继续向“陷阱和问题”部分添加棘手的示例。
贡献内容: - #17887:解决了问题 17887:在特殊子模块中添加了缺失的文档字符串部分。我在由 L 编辑的 Specials 子模块的部分函数中添加了缺失的“参数和示例”部分。我很高兴能够遵循最新的风格指南,并充当未来文档字符串的范本。
以下是我的合并后的 PR 的链接:https://github.com/sympy/sympy/pull/19334
- #19591 :问题 19591 跟踪文档样式指南。我添加了一个 PR,以修改 core.sympify 文档字符串,使其符合最新样式指南。我添加了关于不同参数用法的结构化说明和示例。
以下是 PR 的链接:https://github.com/sympy/sympy/pull/19613
项目目标
时间表 8 月 17 日之前:
- 继续为组织做贡献。
- 更加熟悉用户文档和当前版本的 sympy。
- 学习有助于实施项目的技巧和技能。
社区凝聚力:(2020 年 8 月 17 日 - 9 月 13 日)
- 建立沟通渠道和沟通时间(由于时差)。
- 优化我的目标,并为双方设定预期。
- 讨论模块的更新顺序。
- 最终确定编辑模块的顺序,使它们符合最新的文档字符串样式指南。
文档记录周期(2020 年 9 月 14 日 - 2020 年 11 月 30 日):
设定每周要达成的目标,最好每周完成一个模块或子模块的文档字符串的更新或更多。
对于所有这些模块,我的主要目标是添加缺少的章节并重构文档字符串,以遵循最新的样式指南。这包括展示将不同的值传递给参数时获得的不同结果。所有棘手的输出内容都应添加到“问题和错误”部分。
第 1 周(9 月 14 日 - 9 月 21 日):核心
第 2 周(9 月 22 日 - 9 月 29 日):函数:子模块组合
第 3 周(9 月 30 日 - 10 月 6 日):函数
第 4 周(10 月 7 日至 10 月 14 日):简化、加密
第 5 周(10 月 15 日至 10 月 21 日):Diophantine
第 6 周(10 月 22 日 - 10 月 29 日):全息:操作子模块
第 7 周(10 月 30 日至 11 月 7 日):积分模块 (integrals.integrals),使用梅杰 G 函数计算积分
第 8 周(11 月 8 日至 11 月 15 日):物理学、类别模块结束时的函数、代码生成模块、子模块专题
第 9 周(11 月 16 日至 11 月 23 日):物理学、类别模块结束时的函数、代码生成模块、子模块专题
第 10 周(11 月 24 日至 11 月 30 日):“问题和问题”部分
2020 年 11 月 30 日至 12 月 5 日 18:00(世界协调时间):项目最终提交和报告撰写
2020 年 12 月 3 日至 10 日 18:00(世界协调时间):提交项目成功以及与导师合作的经验
与导师进一步讨论后,可以更改此处提到的单元的顺序。
按照导师的建议,我会重点先更新那些更容易更新的模块,然后再看复杂的模块。
为什么我是此项目的合适人选?
我认为自己是此项目的合适人选,因为我过去曾在计算机科学领域从事技术写作,并且非常熟悉 Git 和 GitHub。
我已经提交了 PR,将文档更新到 sympy 中的最新样式指南,这些文档已成功合并,因此我对工作流程和定期贡献充满信心。
最初在开始贡献内容时,我遇到了一些错误。我终于习惯了每次运行测试和构建文档,然后再提交更改,因为这一点非常重要。
我很擅长为这个项目做贡献,对这项工作充满期待。