软件有多好并不重要，因为如果文档不够好，人们就不会使用它。 即使由于某种原因他们不得不使用它，这是因为他们没有选择，没有良好的文档，他们将不会有效地使用它或者你喜欢它的方式。几乎每个人都明白这一点。 几乎每个人都知道他们需要良好的文档，并且大多数人都试图创建好的文档。但大多数人…

文档的范围很广，本文特指 开发人员撰写的包含基本产品背景和主要技术设计的文档 。 当前的信息共享和长期的知识传承 。对于个人而言，一方面可以 ，比如某次就突然有个同事给我发消息说我的文档写的很好，对新接触这块业务的人帮助很大。 某某同事的感谢. 有很多程序员都持有一个观点：“不…

现在市面上比较流行的方案是约定式提交规范（Conventional Commits），它受到了Angular提交准则的启发，并在很大程度上以其为依据。约定式提交规范是一种基于提交消息的轻量级约定。 它提供了一组用于创建清晰的提交历史的简单规则；这使得编写基于规范的自动化工具变得…

在过去的开发经历中处理了各种奇葩BUG，认识到代码健壮性（鲁棒性）是提高工作效率、生活质量的一个重要指标，本文主要整理了提高代码健壮性的一些思考。 本文将继续探究除了单元测试、打日志之外其余一些帮助提高JavaScript代码健壮性的方法。 同理，后台在处理前端请求参数时，也应…

不知道有没有跟我一样，对于设计模式存在困惑的，以我为例，不瞒大家，我对设计模式真的是“看山就是山”、“看水就是水”、“看理论就是看理论”。毕业之前，我自己捣鼓的东西/项目，几乎没有设计的思想。老夫才不管那么多，直接梭哈，But，正是因为这样，才导致因设计缺陷、代码实现缺陷，为后…

一个页面在呈现给用户之前需要经过静态资源加载、后端接口请求和渲染这三个过程，我们要做的就是在各个过程中防御可能出现的异常情况，保持流畅的用户体验，同时还要应对来自外部的攻击。 在页面内容呈现给用户之前，会一直保持loading动画的效果，避免因网络原因造成用户体验的中断。 静态…