本页面包含 Google 文档季接受的技术写作项目的详细信息。
项目摘要
- 开源组织：
- LibreOffice
- 技术文档工程师：
- Krezhairo
- 项目名称：
- Calc 函数参考文档和用户指南
- 项目时长：
- 标准时长（3 个月）
Project description
项目请求
在技术写作阶段，我可以轻松地每周投入 30-35 小时的时间，在写作前期，我可以投入 10-12 小时的时间，学习项目所需的任何额外技能。谨在此通知您，我目前住在大学（在我的国家/地区），可以使用快速互联网和项目所需的任何附加资源，并且我将在整个项目期间继续在大学上课，因为我们目前处于新冠大流行的形势，我认为大学不会很快开学，即使开学了，我也是大四学生，每周上课只有 5-6 小时，因此不会对项目产生任何影响。
简介
LibreOffice Calc 提供了大量（超过 500 个）函数，属于许多类别，在“帮助”中提供了十分简单易懂的文档（但无论如何都准确）。Calc 的内置函数向导还会向用户提供有关每个函数用途和参数的摘要信息。我们在 Document Foundation 的维基上创建了一个结构，以便收集有关 Calc 函数的更详细的参考信息。
目标
为了通过为 Calc 的每个函数编写更详细的内容来填充 Wiki 结构，我们标记了遵循 ODFF 标准的内容，包括插图和图表，提供了一个或两个示例来指明极端情况和异常，并提供了示例/示例文件。
项目工作计划
我已彻底了解该项目的核心理念，我们本质上是尝试记录函数向导中每个函数的运作方式，并为每个函数提供足够的示例来涵盖函数的各个方面，并尝试使文档尽可能直观，以便新用户查找并在几秒钟内了解如何使用它。
我会考虑按类别划分这些函数：
• Database: This section deals with functions used with data organized as one row of data for one record.
• Date & Time: These spreadsheet functions are used for inserting and editing dates and times.
• Financial: This category contains the mathematical finance functions of LibreOffice Calc.
• Information: This category contains Information functions.
• Logical: This category contains Logical functions.
• Mathematical: This category contains the Mathematical functions for Calc.
• Array: This category contains the array functions.
• Statistical: This category contains Statistics functions.
• Spreadsheet: This section contains descriptions of the Spreadsheet functions together with an example.
• Text: This section contains descriptions of the Text functions.
• Add-in: The following describes and lists some of the available add-in functions.
每个类别包含大约 20-50 个功能，只有少数类别包含更多功能。其中大多数都包含一个包含语法和一个示例的简要说明。
我想为 Calc 的每个函数添加更详细的内容，标记对 ODFF 标准的遵循情况，包括在必要时使用插图和图表，以备注的形式提供一两个示例来说明极端情况和例外情况，并提供示例/示例文件。此外，在适当位置添加了重要部分。 我将考虑以分类格式来研究这些函数，即先挑选一个类别，然后垂直工作，然后在技术写作期间换到另一个类别。此外，我会考虑在社区互动期适应工作环境，以便在编写阶段更轻松地完成工作。根据我的经验，记录这类应用时，需要花费时间来发现所有可能出现的小问题。从规划的角度来看，一开始我会先浏览这 11 个类别，然后再着手处理项目。当然，有些类别需要更多帮助，因此需要比其他类别花费更多时间，但这些问题可以在工作中解决。由于已经有一些文档，我会在此基础上进行编写，因此我会考虑在每周完成任务后进行校对，因为不宜留到最后一周。
因此，下面是关于如何在规定时间内整理项目的大致时间安排。
- 第 1 周：（9 月 14 日） • 数据库
- 第 2 周：（9 月 21 日） • 日期和时间
- 第 3 周：（9 月 28 日） • 财经
- 第 4 周：（10 月 5 日） • 信息
- 第 5 周：（10 月 12 日） • 逻辑
- 第 6 周：（10 月 19 日） • 数学
- 第 7 周：（10 月 26 日） • 数组
- 第 8 周：（11 月 2 日） • 统计
- 第 9 周：（11 月 9 日） • 电子表格
- 第 10 周：（11 月 16 日） • 文字
- 第 11 周：（11 月 23 日） • 插件
- 第 12 周：（11 月 30 日至 12 月 5 日）（最终）
记录完成的工作和从此项目中获得的经验，并处理一些小事（包括第二次校对/编辑，如果需要的话），以便文档准备好提交。