Microcks文档链接修复与版本升级指南

Microcks作为一款优秀的API模拟和测试工具，近期在1.10.1版本中被用户发现存在多处文档链接失效的问题。本文将详细介绍这一问题的背景、影响范围以及解决方案。

问题背景

在Microcks 1.10.1版本中，用户界面中的"帮助菜单"部分包含了大量指向microcks.io文档的外部链接。由于项目文档结构进行了迁移调整，这些链接未能及时更新，导致用户点击后出现404错误页面。

影响范围

受影响的文档链接主要集中在以下几个功能区域：

1. API模拟相关文档：包括REST、AsyncAPI、Postman、SoapUI、GraphQL和gRPC等多种API类型的模拟配置指南
2. 测试功能文档：涵盖测试入门指南、一致性指标说明、Postman和SoapUI测试定义方法等
3. 自动化集成文档：涉及Jenkins、GitHub Actions、Tekton等CI/CD工具的集成说明
4. API/服务管理界面：在API详情页和端点详情页中的"了解更多"链接

解决方案

开发团队已在1.11.x分支中修复了这些问题，用户可通过以下方式获取修复后的版本：

1. 使用nightly构建版本：在Quarkus项目的application.properties配置文件中添加：

   quarkus.microcks.devservices.image-name=quay.io/microcks/microcks-uber:nightly
   

2. 等待1.11正式版发布：该版本将包含所有修复内容，可通过项目里程碑页面跟踪发布进度

注意事项

1. 使用nightly版本时，建议先删除本地旧镜像：

   docker rmi quay.io/microcks/microcks-uber:nightly
   

2. 目前nightly版本中仍有一个文档链接（Mocking Reference）尚未修复，团队正在处理中

3. 对于Podman用户，同样适用上述解决方案

总结

Microcks团队对用户反馈响应迅速，已及时修复了大部分文档链接问题。建议需要完整文档访问功能的用户升级到nightly版本或等待1.11正式版发布。同时，团队鼓励用户分享使用经验并加入项目采用者名单，共同推动项目发展。