我想说的是:编写完善、无障碍、流畅的环境搭建指南,只是我的起点。 我相信,任何技术与工具,最终都是为人、为项目、为业务服务的。如果能不依赖图片、不依赖流程图(这些占用文档资源的形式),仅通过文字描述的清晰度和步骤的明确性,就能把技术的复杂度、工具使用的复杂度、版本冲突与不兼容的探索成本,彻底降低—— 那么,这种被极致解构并组织得流畅清晰的指引,本身就该成为技术体验的一部分。 它应当让人感受到:技术本可以如此简单、直接、可掌控,就像我们今天使用 AI 工具一样自然。 而我几乎很少见到这样的文档。 每当我写文档时,总是本能地极致细化,只为确保未来再次经历相同场景时,不会踩坑、不会卡壳,甚至希望它能成为“傻瓜式指引”,像吃饭喝水一样顺畅。 也许我的想法有些天真,或过于理想,但我愿意在学习中去做,在实践中调整。不同环境总有难以预测的问题,正因如此,我才更想做这件事——即便它暂时没有经济价值。📝 说明这不是一篇技术教程,而是一次坦诚的分享: 为什么我更愿意写文档,而不是只写代码? 希望这段文字能带给你一点力量。 这是我在 Hardhat 官方 GitHub 仓库中回复团队的一段话,原文为...