让你的文档从静态展示到一键部署可操作验证

· 浏览次数 : 0

小编点评

## Document Function Calculation: A Solution for Improved User Experience **Problem:** * Documents are often outdated and difficult to understand due to lack of maintenance and insufficient updates. * Code examples provided in the document are outdated and do not reflect the current functionality. * Users need to manually configure and set up their environment before using the document, which can be challenging for beginners. **Solution:** * Introduce **Document Function Calculation** as a serverless approach for dynamic document validation. * Users can quickly deploy and test code functionality without managing servers or infrastructure. * Function calculation supports various languages, eliminating the need to purchase and manage separate servers. * Users can directly access and test the code functionality within the document, improving the user experience. **Benefits:** * **Improved User Experience:** * Users can deploy and test code instantly with a single click. * Reduced setup time and error rates, making the process more accessible. * **Enhanced Code Quality:** * The document provides a complete, ready-to-deploy codebase, eliminating the need to build and configure projects. * This reduces the cost and complexity of code validation. * **Seamless Knowledge Transfer:** * Users can access and understand the code functionalities directly within the document. * This eliminates the need to learn separate code snippets and navigate between multiple pages. **Implementation:** * **Serverless Devs**: Develop and build a complete application template. * **One-Click Deployment**: Configure the application and document to support one-click deployment. * **Testing Page**: Provide a dedicated page for testing code functionality, with pre-filled parameters. * **Testing**: Trigger function calls and display results directly on the page. **Conclusion:** By introducing Document Function Calculation, we aim to significantly enhance the user experience by providing a dynamic and interactive solution for code validation. This approach eliminates the challenges associated with outdated documents and provides users with a seamless and efficient way to learn and utilize the functionality.

正文

用户在根据文档进行操作时,会出现根据文档内容搭建环境困难、代码调试失败、功能无法使用的情况,主要是由于文档中有年久失修、没人维护、无法跑通的代码,给用户快速上手带来很多的挑战。为了解决文档中的这些用户体验问题,通过函数计算的能力让阿里云的文档从静态展示升级为动态可操作验证,用户在文档中单击一键部署可快速完成代码的部署及测试。这一改变已在函数计算的活动沙龙中得到用户的认可,你也快来体验一下吧~~

用户问题及痛点

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

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

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

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

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

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

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

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

函数计算是一种 Serverless 架构模式,专注于事件驱动的函数编程,提供端到端的解决方案。用户使用函数计算,不需要采购与管理服务器等基础设施,只需编写并上传代码或镜像。同时函数计算支持多种编程语言,函数创建完成后可以快速调试验证。

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

实现方案

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

  1. 通过 Serverless Devs 工具开发并发布完整代码对应的应用模板。
  2. 在文档中配置一键部署,将代码片段与应用模板关联,并发布文档。
  3. 用户在文档中单击一键部署后,根据应用名称在函数计算部署应用,并可以直接测试代码功能。

文档效果

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

用户可以在文档中使用一键部署的入口

1)文档最上方

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

单击一键部署后

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

部署并查看应用

  1. 应用部署成功后,可以查看应用的基本情况。
  2. 单击操作列的测试,即可进入函数计算提供的测试页面。
  3. 在测试页面,已默认将测试参数填入,单击测试函数,即可根据参数进行函数调用。
  4. 最终会返回函数调用返回结果。

用户反馈

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

 

总结

文档中增加一键部署后有以下优势:

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

原来用户在文档中看到的是文字说明及代码片段,要自己搭建环境,构造完整的项目代码使用该功能,耗时不仅长且容易出错,对于新手用户不友好。 现在用户可以直接单击一键部署即可以快速体验该功能,不仅提高操作效率,还可以降低使用过程中的错误率。

2)快速验证代码的正确性

原来文档中提供代码,需要用户单独构建项目环境验证保证代码正确性,整体成本高。 现在文档中的代码已关联完整的可运行代码,可以快速部署验证代码正确性,降低代码验证的成本。

3)快速获取完整代码

原来文档中的代码大部分是研发提供的代码片段,并未提供完整的代码,导致代码片段和可完整运行的代码割裂,用户无法快速从文档获取完整的代码。 现在文档中的代码统一在 GitHub 仓库维护,文档中呈现代码片段,每次变更可找到源码修改,用户可以通过文档操作获取到完整代码。

最后

好的文档应当超越文字的界限,成为知识传递和技能培养的桥梁。阿里云函数计算让我们朝着这一目标迈出了重要一步。我们将文档从传统的静态页面升级为一个动态的、互动性强的工具,用户可以通过一键部署直接在函数计算平台验证文档内容。这种转变较大地提升了文档的可操作性和实际应用价值,让用户不只是阅读和理解概念,还能通过实际操作使用该能力。

我们诚邀所有用户来体验函数计算文档从静态到动态的转变,希望通过你们的参与和反馈,不断优化文档,助力每位用户在学习和使用文档的过程中实现最大化的收益。

如果您希望体验文档的一键部署能力,可以访问下面文档链接。

作者:慕扉

原文链接

本文为阿里云原创内容,未经允许不得转载。

与让你的文档从静态展示到一键部署可操作验证相似的内容:

让你的文档从静态展示到一键部署可操作验证

用户在根据文档进行操作时,会出现根据文档内容搭建环境困难、代码调试失败、功能无法使用的情况,主要是由于文档中有年久失修、没人维护、无法跑通的代码,给用户快速上手带来很多的挑战。为了解决文档中的这些用户体验问题,通过函数计算的能力让阿里云的文档从静态展示升级为动态可操作验证,用户在文档中单击一键部署可

<Python全景系列-1> Hello World,1分钟配置好你的python环境

欢迎来到我们的系列博客《Python360全景》!在这个系列中,我们将带领你从Python的基础知识开始,一步步深入到高级话题,帮助你掌握这门强大而灵活的编程语法。无论你是编程新手,还是有一定基础的开发者,这个系列都将提供你需要的知识和技能。这是我们的第一篇文章,让我们从最基础的开始:如何在你的电脑上配置Python环境。

[转帖]让 CPU 告诉你硬盘和网络到底有多慢

https://cizixs.com/2017/01/03/how-slow-is-disk-and-network/ 简介 经常听到有人说磁盘很慢、网络很卡,这都是站在人类的感知维度去表述的,比如拷贝一个文件到硬盘需要几分钟到几十分钟,够我去吃个饭啦;而从网络下载一部电影,有时候需要几个小时,我都

[转帖]JVM优化之调整大内存分页(LargePage)

转自:http://cjjwzs.iteye.com/blog/1059381 本文将从内存分页的原理,如何调整分页大小两节内容,向你阐述LargePage对JVM的性能有何提升作用,并在文末点明了大内分页的副作用。OK,让我们开始吧! 内存分页大小对性能的提升原理 首先,我们需要回顾一小部分计算机

[转帖]怎么查看Linux服务器硬件信息,这些命令告诉你

https://zhuanlan.zhihu.com/p/144368206 Linux服务器配置文档找不到,你还在为查询Linux服务器硬件信息发愁吗?学会这些命令,让你轻松查看Linux服务器的CPU,内存,硬盘,SN序列号等信息,根本就不用去机房。 一、查看CPU信息 CPU信息常常包括查看C

一文带你了解内部开发者门户

内部开发者门户(internal developer portal)是一个自助服务的应用程序和数据存储,可以为软件工程团队提供提供访问所有软件组件、资源、环境、工具和文档的能力,让开发人员和管理人员跟踪并组织其工程团队构建和运行的所有内容。 信息碎片化问题常常困扰着运行复杂分布式系统的软件工程组织,

如何让你的结构体更高效

> 文中所涉及到的代码运行结果均是在64位机器上执行得到的. ## 基础知识回顾 在Go中,我们可以使用`unsafe.Sizeof(x)`来查看变量所占的内存大小。以下是Go内置的数据类型占用的内存大小: | 类型 | 内存大小(字节数) | | : | : | | bool | 1 | | in

PPT 笔刷:让你的PPT充满视觉冲击

其实就是下载的AI效果 辅助文字展示 辅助图片展示 创意展示图片,增强视觉冲击力 使用 删除外面的边框 https://www.bilibili.com/video/BV1ha411g7f5?p=16

想让你的工作轻松高效吗?揭秘Java + React导出Excel/PDF的绝妙技巧!

**前言** 在B/S架构中,服务端导出是一种高效的方式。它将导出的逻辑放在服务端,前端仅需发起请求即可。通过在服务端完成导出后,前端再下载文件完成整个导出过程。服务端导出具有许多优点,如数据安全、适用于大规模数据场景以及不受前端性能影响等。 本文将使用前端框架React和服务端框架Spring B

LlamaFS自组织文件管理器

LlamaFS是一个自组织文件管理器。它可以基于文件内容和修改时间等属性自动重命名和组织您的文件。它能让你不把时间花在对文件的复制、粘贴、重命名、拷贝、排序等简单操作上。有幸在Github上看到LlamaFS这个repo,感慨万千。 技术简介 LlamaFS以批处理模式和监视模式两种模式运行。在批处