Linux 文档项目周刊

期号 15
出版日期 2004-04-14

目录
1. 待审阅文档
2. 新文档提议
3. 更新的 HOWTO、FAQ 和指南
4. LDP 世界新闻
5. 关于 LDP 列表的讨论
6. Emma Jane Hogbin 访谈
7. 如何为 LDP 贡献

1. 待审阅文档


2. 新文档提议


3. 更新的 HOWTO、FAQ 和指南


4. LDP 世界新闻


5. 关于 LDP 列表的讨论


6. Emma Jane Hogbin 访谈

图 1. Emma Jane Hogbin

问:首先是经典问题:您是如何、为什么以及何时参与进来的?

答:嗯,我一直有点像个文档狂 [编者注:那是一个文档狂热者]。与我的许多其他技术导向的朋友不同,我在尝试安装软件时实际上会写笔记。然后我会回去检查我的笔记,以确保事情被正确记录下来。如果我需要再次安装该软件,这会让生活轻松很多。举个例子:在我笔记本电脑上运行 Debian Linux 的第一年,我不得不重新安装系统大约六次。(是的,我和你一样震惊。)每次我的笔记都会改进,并且我执行每个必需步骤的速度都会更快一些。

我为特定应用程序编写的第一个公开可用的文档是关于 ht://dig(一个很棒的小搜索引擎)。该文档受到了当时我的客户以及 ht://dig 社区的欢迎。虽然我的文档一直受到工作上的赞赏,但这是我第一次收到来自用户社区的认可。

我提交给 LDP 的第一个被接受的文档是 ACPI HOWTO。最初,这只是我自己为安装过程做的笔记。我将这些笔记提交给各种邮件列表以确认其准确性。我收到了很多好的反馈,Sebastian Henschel 要求我为 ACPI4Linux 团队 在线发布它们。Werner Heuser 建议我将文档提交给 LDP。Tabatha 做了我的语言审查,并开始给我发送非常礼貌的电子邮件,建议也许我愿意成为一名技术审阅员。接下来我知道的是,我已经自愿重写作者指南(总共大约九个月的工作),突然我就成了一名成熟的技术和元数据审阅员。

我最初的 ACPI HOWTO 现在需要为 2.6 内核进行重大修订,我一直在准备开始这项工作。Ariel Glenn 将帮助我进行重写(实际上我现在很期待这个过程)。

问:我冒昧地浏览了您的简历。就您的就业而言,您似乎做得相当好,并且与您在大学期间学习的科目相符。但随后在 TLDP 中,我看到您审查了 USB 闪存盘 HOWTO 和 BLFS 文档,并撰写了 ACPI HOWTO。您是如何对这些产生兴趣的?

答:目前我正在进行两种类型的审查:元数据和技术审查。对于技术审查,我需要了解一些关于我正在审查的主题的知识。我目前有一个 USB 钥匙链和一个 USB 摄像头,所以对我来说审查 Niko 的 USB 闪存盘 HOWTO 是一个很好的匹配。

元数据审查着眼于一组不同的事物,特别是文档的标记(DocBook/LinuxDoc 是否有效?)以及文档发布的许可证。还有更多内容,但这些是元数据审查中最耗时的两件事。当我进行元数据审查时,我也会倾向于扫描文档以查找技术/语言上的不准确之处,但我不会在这上面花费大量时间。

然后我有第三组职责:撰写文档。我目前是 LDP 上三个文档的作者:ACPI HOWTO、作者指南审阅员 HOWTO。第一个(ACPI HOWTO)只是我根据自己对必须解决的特定问题的笔记编写的文档。第二份文档和第三份文档更多是关于 LDP 的“流程”文档。LDP 有很多志愿者,其中许多人在文档的发布中发挥着关键作用。我一直在努力记录其中一些流程,这样如果志愿者需要帮助或决定退休,就会有关于如何执行该志愿者任务的说明。

问:作为一名女性在 TLDP 中,您是否曾遇到过困难或限制?以及永恒的问题:我们应该做些什么来吸引更多女性志愿者?男性应该做些什么来吸引更多女性加入这个和其他 Linux 项目?

答:我发现的唯一限制是我要做更多的工作!列表中的男性擅长讨论 LDP 的总体方向,而女性似乎更擅长处理新文档以将其收集到 LDP 中(以及删除旧的/过时的文档)。在处理文档方面,我主要与三位女性和 Greg Ferguson 合作——这并不是说没有男性志愿者!只是他们不是我在文档处理方面合作最多的人。

然后我看看我在整体图景方面所做的工作,它主要是男性(和两位女性)。Saqib Ali 和 David Horton 在工具和文档转换方面给了我很大的帮助。正如我上面提到的,Greg 负责发布文档。Stein Gjoen 和我就图书馆友好的文档存储和元数据进行了许多有趣的对话。大多数许可讨论都是由我们团队中的男性领导的。

尽管我很想说男性需要做些什么来吸引更多女性参与进来,但我认为这实际上取决于女性。是的,那里有一些男性笨蛋,但也有一些女性笨蛋。总的来说,我的建议是:当笨蛋行为不端时,让他们知道他们的行为有什么问题;然后在他们表现良好时感谢他们的帮助。如果一个小组中有大量的笨蛋,那就找一个新的小组。我没有因为男性行为不端而退出过任何一个 Linux 小组。

那么我们如何才能吸引更多女性参与进来呢?好问题。我没有很多技术导向的女性朋友。而那些技术导向的朋友都忙于工作,没有考虑切换操作系统。这是一个漫长而缓慢的过程,但我认为,随着 Linux 桌面应用程序的成熟度不断提高,然后超越 Windows/Mac 上的应用程序,我们将看到更多女性参与 Linux。当然,我接触 Unix/Linux 的时间相对较晚。我从小就是一个 Mac 迷,然后在大学期间转到 Windows。我在 2000 年尝试过 Linux,但当时我需要的应用程序不够稳定。我在 2002 年再次尝试,并一直在这里。

问:根据您的说法,TLDP 可以在哪些方面做得更好?

答:我知道这需要多少工作,因为我是一名审阅员,但是……我希望看到整个文档集都被审查。我希望有志愿者力量在每个文档发布一周年时审查它。届时,该文档要么 “保持原样” 保留在文档集中,要么从文档集中删除,要么在特定条件下保留(例如,我的 ACPI HOWTO 需要包含有关 2.6 系列内核的信息)。审查日期将基于文档的周年纪念日,而不是基于 “上次更新” 日期。

还有销售马克杯。 T 恤 很不错,但我真正想要的是一个马克杯。


7. 如何为 LDP 贡献

Linux 文档项目 (TLDP) 致力于为 GNU/Linux 操作系统开发免费、高质量的文档。如果您想帮助 TLDP,请考虑加入.

帮助我们创建这份新闻通讯。我们需要志愿者关注社区(邮件列表、新闻组、网络频道)并报告与自由软件文档相关的事件。请写信给我们:.

LDP 周刊由 Machtelt Garrels 和 Y Giridhar Appaji Nag 编辑和编译,并得到其他几位人士的帮助。