推荐布局
标签
标签功能对于文档的可被搜索性非常重要,如若维护不善,将会降低知识库的利用率。
设定:
-
编辑状态下左上角
-
查看状态下,右下角
推荐维护方式:
-
主标签:推荐自动带出来。如需求/技术文档/故障修复,配置指南,市场素材等
-
副标签:自主设定
限制(设定可见范围)
操作:
-
有两档权限,仅查看,可编辑。
-
可在权限中增加 用户或用户组
经验:
-
权限只能子页面比父页面更小,如果想要让子页面拥有比父页面更大的权限需要 使用 external share 插件
-
页面的权限从 空间权限基础上叠加,推荐空间权限多配置用户组(便于维护),页面可限定到个人。
优化
定期把不常用的文档手动归档或 查看技术支持工程师中的《清理》功能
不用文档归档:创建一个归档的页面;使用截图中的以层级方式查看,如有space admin 插件,按住 shift 按钮即可直接在当前页面调整。
调整目录结构:
-
根据实际管理/业务需要调整目录结构。
-
并把修改的内容概要,原因写在本空间的主页/导航页
内容类型
概述
内容分为两种大类,模板和自定义内容;全局模板由系统管理员定义,空间模板可由空间管理员定义;
系统模板
以下三块分别为 系统空间,个人空间,右侧欢迎词的配置界面。
推荐可在欢迎词中录入一些常用链接或 quickstart 帮助新用户快速上手系统。
全局模板
拥有 confluence-administrator 用户组,登录后台【站点管理】→【一般配置】→【全局模板和蓝图】
从系统创建的模板,除了有单一文档外,还会有个索引页,通过属性宏拉取相关文档的摘要信息以列表形式展现。
常用模板有:会议纪要,产品需求,回顾会,排障文档,指导文档
空间模板
当用户具备管理空间权限时,即可通过 【空间管理】→【内容工具】→【新增模板】,空间模板仅在当前可见可被引用,其他空间不可见。
通过【推送】使相应模板可以在点击【…】选择模板时置顶显示,其他都会隐藏到显示更多记录中;
自定义页面
点击创建后,出空白页面,随意写内容
权限配置
推荐配置
类型 |
说明 |
截图 |
---|---|---|
空间管理员 |
所有都可操作 |
|
普通用户 |
|
|
匿名访问 |
需在全局的匿名访问打开时,此功能才会起效 |
经验
-
尽量往加组,少开特殊权限模式,一旦特殊权限多,后续维护难度会陡增
-
权限从实例→空间→页面→子页面,只能逐层变小,如要打破上级权限约束,需导出文档外发,或使 用 external share 插件,生成类似网盘的共享链接。
受限页面
在此页面查看当前空间设定过权限的页面,如果是空间管理员,可以对此做修改。
检查权限
类似 Jira 的权限检查助手,属于用户和页面告知页面为何不可见,帮助诊断权限问题。
全局权限
菜单路径:站点管理→一般配置→查看全局权限
参考文档:Permissions and restrictions
功能 |
说明 |
建议 |
---|---|---|
全局权限 |
|
|
未授权访问 |
有 Atlassian 授权但无 Confluence 授权 如 JSM 用户的访问 |
一般的场景用在 JSM 用户检索文档后,在服务台打开查看 |
匿名访问 |
无需任何账号即访问; 查看站点,查看用户可配置 |
谨慎开放此功能,仅公共文档如 FAQ,产品操作说明开放此选项 |
用户配置组
概述
设定组,给组赋予全局权限,把用户加到组里,这是最常用的操作方式。如何设定组,一般是不使用内置用户组,而是根据公司的组定义,如来自 AD ,LDAP,或者使用 Atlassian Jira 或 Crowd 来管理组。
组类型
-
普通组:普通组,一个人可以同时在多个组里
-
嵌套组:即组之间存在父子关系,子组权限会从父组中继承
-
注意:嵌套组可能会导致用户查询的性能问题。
用户组
-
菜单路径:站点管理→一般配置→用户组
-
参考文档:
-
https://confluence.atlassian.com/conf716/confluence-groups-for-administrators-1108682902.html
-
操作说明:创建/删除/把用户添加到组内
配置全局参数
Logo 设置
-
菜单路径:站点管理 → 一般配置 → 站点 Logo和图标 / 空间 Logo
-
参考文档:
-
https://confluence.atlassian.com/doc/changing-the-site-logo-138567.html
-
操作说明:更新图片后,空间,站点 Logo ,网页标签 也 随之更新
定期清理
-
菜单路径:站点管理→一般配置→定期清理
-
参考文档:
-
https://confluence.atlassian.com/conf716/set-retention-rules-to-delete-unwanted-data-1108683105.html
-
清理经验:为保证搜索的相关性以及系统的可用性,建议定期清理附件和归档空间 Cleanup guide
-
操作说明:
-
点击【查看分析】查看近期的空间使用情况
-
设置【查看保留规则】,设置保留的文档,确保重要数据不被归档或删除
-
存档【查看所有空间】把不用的空间存档,提升搜索相关性,准确性
协同编辑
-
菜单路径:站点管理→一般配置→管理→协同编辑
-
参考文档:
-
https://confluence.atlassian.com/conf716/administering-collaborative-editing-1108683292.html
-
操作说明:
-
点击打开,即开启多用户协同编辑,若不打开,则当前用户编辑时,文档即被锁定,若同时有用户编辑,提交保存时会提示发现冲突,合并还是覆盖。
-
协同编辑后端依赖项较多,遇到问题时建议使用,文档,谷歌,ACE 社区进行排障
移动端应用程序
-
菜单路径:站点管理→一般配置→管理→移动端应用程序
-
参考文档:
-
https://confluence.atlassian.com/doc/confluence-mobile-284365706.html
-
操作说明:
-
用户:iOS 用户可直接从 APPSTORE 下载,安卓用户需要使用梯子才能打开 google play;若实例部署在内网中,需连续 局域网或 打开 VPN 才能使用 手机 APP
-
管理员:打开允许推送通知
-
手机APP 仅支持标准内容查看,编辑,不支持大多数插件的使用。
分析功能
-
菜单路径:站点管理→一般配置→管理→分析功能
-
参考文档:
-
https://www.atlassian.com/legal/privacy-policy
-
https://confluence.atlassian.com/conf716/analytics-1108682559.html
-
操作说明:
-
打开发送开关,相关使用数据会在脱敏情况下发给 Atlassian 用户改善产品体验
-
概述:近期站点的使用情况,热门空间,用户等
-
空间:空间使用统计
-
用户:登录以及创建内容的统计
应用导航器
-
菜单路径:站点管理→一般配置→应用导航器
-
参考文档:
-
https://confluence.atlassian.com/conf716/configuring-the-site-home-page-1108682988.html
-
操作说明:
-
Configure Application Links 中创建过的 Atlassian 链接会自动添加链接至导航器
-
添加其他相关站点,并可以限制可见的用户组
运营
概述
系统安装配置,完成短期项目容易,但维护难,如何在阶段项目结束后,依然保证系统长期稳定运行,和内容健康输出,才是 Confluence能否为企业带来价值的关键,一个靠谱的管理员,制定合理的运营规则非常重要。
新手任务
帮助刚入职的员工快速了解操作方法,常见资料如何使用,做个打卡任务页面,全部完成后送个纪念品,小红花啥的。
定期数据报表
分析页面,空间使用率,分析知识库问题,给出改进建议,比如内容太多,速度太卡,搜索准确度不够,内容准确度待提升,复用率待提升等。
定期表彰
对于文档输出,被阅读量大的知识贡献个人或团队予以表彰,发小礼品和奖金,鼓励大家输出高质量内容。
公司最大的资产是人脑子里的知识和产品内部的科技指数,客户满意度。建好的知识库,投入产出比是很高的。
常见错误
过多管理员
让不具备Confluence内容管理经验的运维技术人员,充当超级管理员,导致各种不经变更流程的配置,最后导致系统混乱,出错。
缺少变更管理
和上述问题类似,系统变更缺少记录和审核,导致重要变更未经过足够的测试,验证,通知干系人,造成变更后的风险陡增。
缺少模板/结构/更新流程
好的 Confluence 应该让用户专注于写内容,而不是思考用哪个模板,写在哪里,怎么更新。
事先规划化,才能不乱,不给公司,团队制定文档更新规则,基本用到后面就是一团乱。
缺少整理
定期需要整理目录,归档空间,删除附件,否则用户观感就是变卡和混乱。
这需要花时间,知识库乱如同技术债,越早清理,越少麻烦。
头痛医头脚痛医脚是下策,如果深究软件开发问题根因,多数不是出于开发,而是源头需求理解不一致,项目多方协同困难,信息更新不及时。
运维工程师充当系统管理员
很多公司喜欢请运维工程师充当 Confluence Admin,导致后果就是早期无设计,中期无维护+评估变更需求,后期通过不停打补丁加机器来救火,最后一地鸡毛。
典型省小钱吃大亏,想要建设靠谱的知识库,要么花大钱请个专职,熟悉 Atlassian 产品的管理员,要么外部请服务公司,如果这两笔钱都不愿意花,也无需打肿脸充胖子用外国产品,从实际业务出发,为提升生产力,在无外部服务的情况下,轻量级国产免费 TADP 飞书反而更好。
文章评论