其他
Recap | Go 在 Apache Pulsar 上的应用与实践、开源项目中文档的实现
🎙️阅读本文需 4 分钟
上周,StreamNative 的小伙伴们行程满满,为大家带来了一场又一场出色的分享。
素有 Apache 龙之称的冉小龙在上周出席了 GitHub 中国见面会、Google DevFest 北京站的活动,并在两次活动里分享了 Go 在 Apache Pulsar 上的实践应用等。
另外,在12 月 7 日,Yu Liu 参加了「中国技术传播大会」,这是技术传播行业最大的盛会之一。她为大家分享了 Pulsar 社区的文档开发流程和 Docs Like Code 如何提高 Pulsar 社区的文档开发效率和质量。
以下是相关会议的简单回顾,如需演讲原件,可直接点击文末「阅读原文」获取。
>>> GitHub 中国见面会 <<<
🎙️题目:Go in Apache Pulsar
此次 Talk 详细介绍了 Apache Pulsar 社区如何利用 GitHub 开展社区互动,以及 Go 在 Apache Pulsar 项目里的应用与实践。包括:
Apache Pulsar 社区与 Github 的关系,如何利用 Github 进行开源社区的互动与增长。 Apache Pulsar 介绍,云原生、多租户等特性。 Go client 在 Apache Pulsar 的实践,CGO 是什么以及相关使用感悟。
介绍了 Apache Pulsar 的架构设计、特性以及和其它 message queue 的区别。 介绍了Pulsar Functions 的设计理念以及架构。 介绍了 Go Functions 的实现以及与 Function runtime 和 Function worker 之间的关系。
开源项目、Rest API 和 SaaS 的井喷式发展极大地增加了文档需求。 敏捷开发带来大量文档的多版本管理问题。 开发人员和技术文档工程师在思维方式、工作流程和工作方式中的差异。
文档存储在版本控制系统中(例如,Git),有利于解决文档多版本管理问题。 文档的撰写使用轻量标记语言(例如,Asciidoc 和 Markdown)和代码开发软件(例如,VS Code),是开发人员熟悉的环境,能减少他们进行技术写作的抵触情绪。 文档和代码一样,持续地进行测试、合并、构建、部署和发布,在 CI 方面使用静态网站生成器(例如,Jekyll),在 CD 方面使用静态网站部署工具(例如, Netlify)。整个过程高度自动化,能减少大量重复且枯燥的人力工作。
文档贡献者拥有更多时间和精力专注于创作文档内容。 极大地促进了技术文档工程师与开发人员、技术文档工程师与用户、所有贡献者之间的连接与合作。 获取长尾贡献。