让你的文档从静态展示到一键部署可操作验证_阿里云云原生的专栏文章_微信文章

用户在根据文档进行操作时，会出现根据文档内容搭建环境困难、代码调试失败、功能无法使用的情况，主要是由于文档中有 年久失修、没人维护、无法跑通 的代码，给用户快速上手带来很多的挑战。

为了解决文档中的这些用户体验问题，通过函数计算的能力让阿里云的文档从静态展示升级为动态可操作验证，用户在文档中单击一键部署可快速完成代码的部署及测试。这一改变已在函数计算的活动沙龙中得到用户的认可，你也快来体验一下吧~~

用户问题及痛点

Cloud Native

阿里云的产品作为技术驱动型解决方案，用户对文档中提供的代码示例有较高的依赖。通过分析，发现用户在使用文档时有以下问题。

文档中提供的代码错误，用户无法直接使用

使用如下的 代码示例，在测试时一直报错，导致用户无法直接使用。 文档中的代码示例由于长时间未更新和缺乏维护，已经变得过时，这直接影响用户使用文档时的体验。

代码示例：

报错信息：

文档中只提供代码片段，用户调试门槛高

文档中只提供代码片段， 缺乏完整的项目结构和环境配置指南，用户需要自己搭建项目和设置运行环境， 才能使用文档中介绍的功能，这无疑增加了用户实际操作的难度，甚至会吓退很多新手用户。

文档中没有提供代码，用户无法参考文档使用该功能

例如：函数计算的配置 OSS 文件系统文档中，只提供给用户如何配置 OSS 挂载，却 没有提供如何访问 OSS 挂载文件相应的代码示例， 这直接导致用户想使用该功能时参考该文档无法获取想要的信息。

原文档内容：

用户期待的文档内容：

解决方案：提供动态可操作验证的文档

Cloud Native

如果文档中的代码能够部署在函数计算平台，那么 用户可以在文档中直接操作验证代码提供的功能， 会直接提升用户使用文档代码的体验。

实现方案

整个解决方案的流程示意图如下所示。

文档效果

以使用函数计算部署通义千问大模型实现 AI 对话文档为例，介绍文档动态可操作的效果。

1）文档最上方

2）支持一键部署的代码片段前面，重点提醒用户可点击。支持一键部署的代码 codeblock 右上角

单击 一键部署 后，会根据配置的应用模板将代码需要开通的服务、角色、配置的参数在面板中呈现，用户需开通及配置。

用户反馈

在 2023 年 12 月的函数计算活动沙龙中，有 70 多名用户体验了该文档的一键部署能力。在 2024 年 1 月的活动沙龙中， 有 2000 多名用户参与任务的体验，其中有 500 用户完成。用户反馈从文档直接部署降低了体验该功能的门槛。

总结

Cloud Native

1）用户文档使用体验提升