6 分钟阅读时间 (1222 字)

认识 Joomla 文档团队

March-JDocs

当你想探索一个你还不了解的功能,或者你想知道一个 Joomla 功能是如何工作的,或者你只想知道如何完成某事时,你会怎么做?大多数人会 RTFM,即阅读详细手册,也就是 Joomla 文档。你知道吗:Joomla 的详细手册并不是自己写的,实际上有真实的人在做这件事。我们采访了其中两位。阅读关于这个优秀团队、他们的重要工作和你可以如何帮助他们或甚至加入他们的所有内容!

团队的主要目标是什么?

Mike Brandner(团队负责人):我们的目标是维护和推广官方 Joomla 文档。在我们的手中,有关于项目 Joomla 和 CMS 的全部知识。每天都有来自世界各地的用户调用我们的文档,了解如何使用我们的 CMS。无论是通过帮助页面还是教程,几乎所有的内容都有文档记录。但这也意味着我们每天都需要许多支持者。

你在 Joomla 生态系统中扮演什么角色?

Mike:我们在 Joomla 生态系统中的位置正是中间。因为我们连接了开发者和社区与我们的产品用户的世界。
作为生产部门的一部分,我们直接接触 CMS 的持续开发。另一方面,用户在 JDocs 中寻找如何使用 CMS 的说明。

你在团队中扮演什么角色?

Mike:作为团队负责人,我每天检查文档的编辑。如果对原始文本进行了更改,我会发布它们以供翻译,翻译团队会支持我。这也适用于新创建的页面。此外,还会定期检查新用户注册并删除垃圾邮件条目。我还试图对工作进行一些结构化并设置优先级。当有活动即将举行时,我会相应地准备待办事项列表,然后由助手处理。每两周生产部门会议举行一次,如果我有时间,我也会参加。在这里,关于 CMS 的开发和生产团队的各个方面进行一般讨论。

此外,目前还有一些关于未来如何进一步发展文档的战略讨论。

最近开始了一项开发者文档(JDevDocs)的测试阶段。如果这能成功,技术文档将在GitHub完成,当前的wiki将更多关注用户。文档团队需要管理这两者。

目前第二项任务是新的工作流程。每次PR都会向CMS添加新功能或更改。我们试图在文档中记录这些,但这几乎不可能。目前我正在寻找一种方法,可以从GitHub的PR中启用向文档的工作流程。

团队成员:请介绍一下自己:)

迈克:我是一名自动化工程师,背景是化学,同时在业余时间从1.0版本开始使用Joomla。我还经营着一个小型代理商,我们为客户创建和维护网站。在那里我使用100%的Joomla。

自从2014年第一次参加JAB以来,我就一直是Joomla社区的一员。

大约六年前我开始支持文档。最初是翻译,然后是翻译协调员,自2019年起担任团队领导。在担任JDocs团队领导之前,我还在营销团队担任社区翻译团队领导约两年。

马汀·莫纳德(团队成员):我现在已经退休了。我在一家银行公司从事ICT工作30年。2007年我开始使用Joomla创建自己的旅行网站。之后,我在荷兰论坛上提供帮助,并组织荷兰JoomlaDays。

我做了很多事情。我的主要工作是照顾荷兰语言包,将发布公告翻译成荷兰语,但这不是Joomla文档团队的工作。对于文档团队,我为文档添加了翻译标签。这些标签 <translate>文本</translate> 标记了需要翻译的部分。这些部分不应该太大,因为较小的部分使得在其它工作之间快速翻译几个句子成为可能。当这些标签放置后,我生成文档,使每个部分都有一个编号。如果源语言中的部分有所更改,翻译者会看到并可以审查他们的翻译。去年,我帮助为Joomla 4的新帮助屏幕添加翻译标签,并当然进行了翻译。我从2014年开始担任成员。

你们多久开一次会,会议是如何进行的?

迈克:我们通常每年开一次会。未来应该更频繁地开会,以便更好地协调我们的活动。团队领导和助理每两周召开一次部门会议。

你们使用什么工具进行协作?

迈克:我们使用Glip保持联系。在JDocs工作期间,我们使用wiki的讨论功能或通过wiki消息系统发送电子邮件,例如通知翻译者。

如果你用三个词来形容团队内的氛围,那会是什么?

迈克:安静!我们在编写文档!

过去一年(几年)中,团队是如何发展的?

迈克:在过去几年中,团队变得越来越小。原则上,现在只有一个小核心活跃。此外,还有一些偶尔的用户也会记录一些内容,但通常他们很快就会变得不活跃。就像大多数wiki注册用户一样。我认为这主要是问题所在,因为重点是产品(CMS)。文档可能看起来没有吸引力且理论化,但对于软件来说,良好的文档至关重要。文档良好的软件是令人愉快的工作,这可以让Joomla脱颖而出。我们在PBF或JoomlaDays等活动中找到了许多助手,我们也在这些活动中推出了工作坊。在这样的活动中,总是有大量的助手,但他们通常不会待很长时间。然而,由于情况,这些活动在最近两年中不幸地被大规模取消。

你们需要额外的志愿者吗?如果需要,需要哪些职位?

Mike: 我们需要许多贡献者帮助我们创建和更新文档。每个人都可以在维基百科上撰写,但应该有更多协调工作。您不必是团队成员就可以支持JDocs。

然而,随着时间的推移,我们的团队已经变小了,我们正在寻找新的成员成为团队永久的一部分。

对成员有什么期望?

Mike: 作为成员,您应该熟悉CMS,并热衷于撰写教程和说明。您还应该在您的Joomla安装(英语)中拍摄截图并将其上传到JDocs。还需要一定的独立性和主动性。您还应该考虑到整体情况,以确保在各个文档之间有良好的导航 - 文档也应在之后可查找。文档必须用英语撰写,之后将进行翻译。我们还在寻找翻译协调员,但他们不必一定是团队成员。

在Joomla社区杂志上发表的一些文章代表了作者在特定主题上的个人观点或经验,可能与Joomla项目的官方立场不一致。

2
Joomla的页面构建器 - Balbooa Gridbox
漫步Joomla论坛内部
 

评论

已经注册了吗? 在此登录
尚未发表评论。成为第一个发表评论的人

通过接受,您将访问https://magazine.joomla.net.cn/外部第三方提供的服务