ShowDoc v3.0 发布 , 提升了产品颜值和操作体验，但是设计师说——

star7th 的个人博客 / 456 / 7 / 创建于 1年前 / 更新于 1年前

地址

开发小故事

在年前，设计师基本为showdoc设计出了一套ui主题。然而直到昨天，我才按设计稿重构了一版UI。虽然外观看着变化也不算非常大，但实际上底层代码已重构掉了一半，很多产品逻辑导致的底层组件封装方式发生了变化，同时我也借此机会修复了历史上不少代码的遗留包袱。
到现在，完成度还没有很高，很多细节没打磨好，大约只达到设计稿原意的六七成。我决定直接先发布一个3.0版，后面的问题后面完善。
设计师说，我习惯一步到位，做完善了再上。
我跟他就这个观点进行了交流，还蛮有意思的。这是两种风格迥异的产品思维。一种是把产品打磨得很好，一出场就惊艳用户。一种是小步快走，分阶段迭代。实际上，我也看过设计师的其他作品，确实给人的第一感觉就很惊艳，其产品给目标用户的第一印象非常好。
对于我的项目而言，我要照顾到开发时间成本和宣发机会，我比较愿意追求留给用户一种 “这个产品一直在优化在进步”的印象，而不需花太长的时间“憋大招”来惊艳用户。
尽管这个观点不同，但是我非常欣赏设计师的产品思维和对细节的追求。后续也继续有意愿跟他合作其他产品。

3.0版本更新了什么

重写了UI和交互逻辑，大大提升了视觉效果和操作体验，包括但不限于以下内容：

展示多个项目时候采用列表结构，同时完善项目分组功能，适合更多项目的场景
大部分打开新页面的操作，如用户中心、目录管理、团队管理等等，都改为当前页面弹窗的形式，方便关闭弹窗后无感回到之前的操作，避免割裂感。
完善拖放组件，涉及到拖放的场景，比如项目分组的拖放、页面排序的拖放、目录管理的拖放，都统一元素高度和样式。
调整项目展示页的布局，包括常规多页项目、单页项目和表格展示项目，增加统一的header和图标样式。
调整功能按钮的展示与收起逻辑，在便捷和简洁间取得平衡。

给新用户看的showdoc介绍

ShowDoc 是一个非常适合 IT 团队的在线 API 文档、技术文档工具，既有开箱即用的在线托管服务版，也有免费的开源版( github 1 万+ star )。通过 showdoc ，你可以方便地使用 markdown 语法来书写出美观的 API 文档、数据字典文档、技术文档、在线 excel 文档等等。如果不想编辑 markdown 文档，你还可以利用 showdoc 的自动化能力，从程序注释中自动生成 API 文档，或者从搭配的 RunApi 客户端（类似 postman 的 api 调试工具）中一边调试接口、一边自动生成文档。无需手动编写文档，释放生产力。通过分配项目成员和团队成员，你可以很方便地进行项目文档的权限管理和团队协作，也可以分享文档出去给朋友查看。ShowDoc 还支持多平台客户端，有 win 客户端、mac 客户端、ios 、android 等，更方便跨平台使用。目前超过 100000+的互联网团队正在使用 showdoc ，包括知名公司内部的一些团队，比如腾讯、华为、百度、京东、字节跳动等等。

关于 Showdoc 的详细介绍，请看： www.showdoc.com.cn/help