暂无图片
暂无图片
暂无图片
暂无图片
暂无图片

openEuler文档生产机制发布与体验升级啦!

OpenAtom openEuler 2025-04-09
184


背景


OpenAtom openEuler(简称“openEuler”)文档中心是面向产品使用者构建的一套围绕社区发行版,覆盖各业务场景与工具的文档体系。在去年社区满意度调研中收集到文档使用者们反馈“用户找指南找了很久才找到”,“现在的文档太复杂了,讲的太多了” ,“文档更新不及时”,“文档没有串联起来的逻辑,感觉像是堆砌”之类的反馈。


经过分析发现,当前的文档信息架构是一套文档包融合所有业务场景,文档堆砌、内容组织混乱,用户无法从当前文档体系中快速查阅自己关心的文档。并且由于当前的文档生产机制,存在沟通审批效率低、文档贡献门槛高等问题,导致文档更新不及时,内容不正确或不完整。


问题解决


针对这些问题,此次文档中心改版升级,提升了文档获取和使用体验。主要包括以下两方面的优化:

① 文档生产机制建立

建立开源文档的生产、发布机制,文档生产下沉到各SIG组,各SIG组协同分工,通过沉淀文档模版、写作规范,加强流水线门禁管理,保障文档质量。

《文档开发指南》已上线官网文档中心,文档开发者可以根据指南参与openEuler文档开发。

② 文档中心重构

按业务场景,分用户角色对产品文档架构进行重构,改变一套文档包融合所有内容的现状,将文档拆分成6大业务场景,7个工具模块,包括70+本手册,同时优化文档中心视觉效果、交互方式、搜索体验、评分机制等。

  • 文档中心首页:按照业务场景和工具分开呈现

  • 手册介绍页:信息架构上按照基础特性和增量特性进行划分,也便于文档贡献者、文档使用者(特别是新手用户)的使用

  • 提升文档内搜索的结果准确率并增加文档评分和问题反馈入口,随时可以对文档质量进行评价,同时也方便定位文档问题,提升文档质量


访问地址


改版后的文档中心已经上线openEuler官网,欢迎体验~

  • 文档中心:https://docs.openeuler.org/zh/

  • 文档开发指南:https://docs.openeuler.org/zh/docs/common/contribute/directory_structure_introductory.html


openEuler Developer Day 2025

现场体验


也欢迎大家来 openEuler Developer Day 2025 展台和用户体验设计专题进行新文档发布机制的流程体验和讨论,会有神秘礼品等您~!

  1. 展台:openEuler社区文档生成机制发布与体验升级

    时间:全天

  2. SIG Gathering 用户体验设计专题

    时间:上午10:00~12:00

    地点:杭州萧山万怡酒店B1层秋月厅


联系我们


如果您在使用过程中有任何建议,可以通过以下方式联系我们,欢迎一起交流讨论:

  1. 邮件列表:doc@openeuler.org

  2. doc仓:https://gitee.com/openeuler/docs

  3. 社区论坛:https://forum.openeuler.org

  4. 微信交流群








文章转载自OpenAtom openEuler,如果涉嫌侵权,请发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。

评论