热门标签：
Mac 多显示器 显示器扩展 requests patch 并发 Alpine Linux BSD Linux 电动汽车 全部标签

我们使用Diátaxis框架修复了文档

2024-12-06

本文讲述了Sequin团队如何利用Diátaxis框架改进文档。他们发现工程师倾向于先解释所有内容，但这并非最佳方法。Diátaxis框架将文档分为教程、操作指南、参考和解释四类，并建议用户按顺序阅读。Sequin团队据此重构了文档，先创建快速入门教程，再编写操作指南，过程中发现并解决了产品问题，最后完成参考文档。Diátaxis框架帮助他们认识到文档的重点是吸引用户并引导他们学习，而非简单地传递信息。

阅读更多
(blog.sequinstream.com)
6
未分类 Diátaxis框架

不存在精确一次交付

2024-09-30

这篇技术博客探讨了消息传递系统中的“精确一次交付”概念，指出由于两阶段提交问题，实现真正的精确一次交付是不可能的。文章解释了“至少一次交付”和“精确一次处理”之间的区别，强调Sequin作为一种消息系统，提供了“至少一次交付”和“精确一次处理”的保证。作者还讨论了如何通过设计幂等系统、将消息分解为工作单元以及正确配置超时等方法来减轻重复处理问题。

阅读更多
(blog.sequinstream.com)
24
未分类 消息传递系统 精确一次交付 Sequin