Jenkins Hackfest 用户体验文档报告
Jenkins 技术文档是我们项目的重要组成部分,因为它是正确使用 Jenkins 的关键。好的文档可以指导用户,并鼓励选择好的实现方式。这是用户体验的关键部分。
在最近的 Jenkins UI/UX hackfest 中,文档是改善 Jenkins 用户体验的特定途径。我们从经验丰富的 Jenkins 贡献者和新人那里获得了许多进步。来自世界各地的贡献者提交了有关安装,管理和操作 Jenkins 文档的 PR。
从Wiki迁移文档
Jenkins Wiki 页面为 Jenkins 用户收集了 15 年的经验和智慧。但是,这种经验和智慧与不准确,不完整和过时的信息混杂在一起。
Jenkins Wiki 迁移项目确定了 Jenkins Wiki 上访问量最大的 50 个页面,并创建了 GitHub 问题来跟踪这些页面到 www.jenkins.io 的迁移。这是我们第一次使用 GitHub 问题作为文档的大规模实验。结果是压倒性的正面。Hackfest 贡献者在许多文档章节中添加了新的章节,包括:
•Jenkins 使用
•流水线
•Jenkins 管理
•系统管理
Hackfest 解决了 Wiki 迁移问题中的 19 个问题。有关其他 25 个 Wiki 迁移问题的工作正在进行中。我们已经取得了长足的进步,并期待将来取得更好的成绩。新的贡献者非常有效地使用了“good first issues”标签。我们以未分配的 25 个“good first issues”中的大多数未分配开始了 Hackfest,并以 14 个已关闭的项目和另外 10 个正在进行的项目完成了 Hackfest。当我们使用 Jenkins Wiki 迁移来欢迎新的文档撰稿人时,我们将提供更多的“good first issues”。
迁移插件文档
插件文档也在过渡中。自 2019 年 11 月以来,插件一直将其文档移至托管插件源代码的 GitHub 存储库中。这种“文档即代码”的方法使插件维护人员可以在实现新功能的相同 PR 中包括文档改进。它确保文档更改由审查和批准新功能的相同维护者审查。
Hackfest 参与者提交了 PR,以将插件文档迁移到 GitHub。Hackfest 正在进行 10 个插件 PR。来自 Hackfest 的 5 个插件 PR 已被合并,正在等待插件的发布。
Chuck Norris 文档即代码
出于娱乐和冒险的精神,Oleg Nenashev 在 2020 年 5 月 26 日的 Hackfest 现场演示中将 “Chuck Norris 插件” 迁移为 GitHub 文档中的代码。可以从以下链接获取录音,插件迁移指南和导出工具的链接:将插件迁移为代码文档”。
文档更新
Jenkins 与其他技术合作,解决了许多不同环境中的自动化挑战。我们在“解决方案页面”中描述了这些环境。作为 Hackfest 的一部分,我们已经对解决方案页面进行了一系列改进。
Docker 解决方案页面现在包括更新的视频和更好的页面布局,以便于阅读和导航。其他解决方案页面将来也会得到类似的改进。
文档更新
可以在启动时通过定义 Java 属性来修改 Jenkins 的全局配置。当新的默认配置可能与现有安装不兼容时,系统属性可以更改系统默认值,并可以提供兼容性“转义阴影线”。
Daniel Beck 作为 Hackfest 的一部分,改进了系统属性页面的导航和用户体验。现在,通过将鼠标悬停在每个属性的右侧以及对每个属性进行分类和分类的标签,可以使用可嵌入的链接来轻松阅读和引用。
插件站点改进
在 Hackfest 期间,Gavin Mogan 继续致力于改善 Jenkins 插件站点,以便用户可以轻松访问插件更改日志和报告的问题。合并此 PR 后,它将极大地改善那些想要更新插件并查找有关其变化和可能遇到的问题的文档的 Jenkins 用户的体验。
Jira 插件的传入 UI 示例:
下一步计划
Jenkins 文档中仍有很多工作要做,我们需要您的帮助。参与 Jenkins 项目的方式有很多,包括文档。请参阅贡献指南以获取详细说明。加入文档聊天室,获得个性化的帮助和鼓励。
Jenkins 项目也已于今年加入 Google Docs。这项开源指导计划使开源社区和技术作家社区聚集在一起,从而使双方受益。我们正在寻找有兴趣为 2020 年 9 月至 12 月对该项目做出贡献的技术撰稿人。这是学习作为文档编码的工具并了解有关为开源项目做出贡献的更多信息的绝佳机会。您可以在此处找到 Jenkins 项目构想和更多信息。
文章来源: jenkins中文社区
作者: Mark Waite Jenkins
Jenkins Hackfest 用户体验文档报告的更多相关文章
- Jenkins 利用HTML Publisher plugin实现HTML文档报告展示
利用HTML Publisher plugin实现HTML文档报告展示 by:授客 QQ:1033553122 测试环境 HTML Publisher Plugin 1.1.2 Jenkins2. ...
- Jenkins构建项目帮助文档
Jenkins构建项目帮助文档 主要步骤 一.配置jdk 1.1. 下载jdk,安装到自己电脑磁盘的Java目录下(比如:D:\Java\jdk). 1.2. Jdk环境变量的配置: 1. 鼠 ...
- SonarQube + Jenkins代码审查环境安装文档 v1.2
1. 安装SonarQube 1.1. 下载 下载地址:https://www.sonarqube.org/downloads/ 本次使用安装包为:sonarqube-7.4.zip 需要提前准备jd ...
- ElasticSearch 5学习(8)——分布式文档存储(wait_for_active_shards新参数分析)
学完ES分布式集群的工作原理以及一些基本的将数据放入索引然后检索它们的所有方法,我们可以继续学习在分布式系统中,每个分片的文档是被如何索引和查询的. 路由 首先,我们需要明白,文档和分片之间是如何匹配 ...
- OpenShare文档中心
文档是企业重要的智力资产.在企业中,文档一般都以电子文档的形式存在,比如微软.doc格式,xls格式,ppt格式,pdf格式,纯文本.txt格式等:从内容上,可能是商务合同.会议记录.产品手册.客户资 ...
- 第四次作业——关于石墨文档(Android)客户端的案例分析
关于石墨文档(Android)客户端的案例分析 作业地址:[https://edu.cnblogs.com/campus/nenu/2016CS/homework/2505] 第一部分调研,评测 1. ...
- ElasticSearch文档操作介绍三
ElasticSearch文档的操作 文档存储位置的计算公式: shard = hash(routing) % number_of_primary_shards 上面公式中,routing 是一个可变 ...
- JavaScript权威指南--脚本化文档
知识要点 脚本化web页面内容是javascript的核心目标. 第13章和14章解释了每一个web浏览器窗口.标签也和框架由一个window对象所示.每个window对象有一个document对象, ...
- 程序员如何编写好开发技术文档 如何编写优质的API文档工作
编写技术文档,是令众多开发者望而生畏的任务之一.它本身是一件费时费力才能做好的工作.可是大多数时候,人们却总是想抄抄捷径,这样做的结果往往非常令人遗憾的,因为优质的技术文档是决定你的项目是否引人关注的 ...
随机推荐
- 一文详解 OpenGL ES 纹理颜色混合
在OpenGL中绘制的时候,有时候想使新画的颜色和已经有的颜色按照一定的方式进行混合.例如:想使物体拥有半透明的效果,或者绘制叠加光亮的效果,这时候就需要用到OpenGLES混合. 如上图所示,为石头 ...
- [Java Web 王者归来]读书笔记2
第二篇 基础篇 第三章 深入Servlet技术 1 浏览器的request http数据报中包含一些关键信息,如访问方式.所用的http版本.所用的浏览器.当前的页面地址等信息 2 http查询数据方 ...
- Docker 快速删除无用(none)镜像
Dockerfile 代码更新频繁,自然docker build构建同名镜像也频繁的很,产生了众多名为none的无用镜像. 分别执行以下三行可清除 docker ps -a | grep " ...
- SQL Server中的函数
字符串函数 日期函数 数学函数 系统函数
- jquery autocomplete 插件的使用
Autocomplete 自动完成 功能:输入框在输入关键字后,根据输入的内容给出相关的下拉框供用户选择,自动完成输入内容. 插件:使用jqueryUI的自动完成小部件,文档地址:https://jq ...
- 【九度OJ】题目1208:10进制 VS 2进制 解题报告
[九度OJ]题目1208:10进制 VS 2进制 解题报告 标签(空格分隔): 九度OJ 原题地址:http://ac.jobdu.com/problem.php?pid=1208 题目描述: 对于一 ...
- 【剑指Offer】10- II. 青蛙跳台阶问题 解题报告(Python & C++)
作者: 负雪明烛 id: fuxuemingzhu 个人博客:http://fuxuemingzhu.cn/ 个人微信公众号:负雪明烛 目录 题目描述 解题方法 动态规划 日期 题目地址:https: ...
- Codeforces 872B:Maximum of Maximums of Minimums(思维)
B. Maximum of Maximums of Minimums You are given an array a1, a2, ..., an consisting of n integers, ...
- 面渣逆袭:JVM经典五十问,这下面试稳了!
大家好,我是老三,"面渣逆袭"系列继续,这节我们来搞定JVM.说真的,JVM调优什么的一个程序员可能整个职业生涯都碰不到两次,但是,一旦用到的时候,那就是救命了,而且最重要的是-- ...
- Java GUI 桌面应用开发
前言 虽然现在已经很少项目会涉及GUI技术,但作为一个合格的Java开发工程师,还是得了解才得 本文记录,idea使用JFormDesigner插件进行Java GUI 桌面应用开发 GUI Swin ...