问对函数式程序建模/文档化

EN

这也是我一直在尝试的东西，经过几年的Ruby编程，我已经习惯了类/对象建模。最后，我认为我为Clojure库创建的设计类型实际上与我为大型C程序所做的设计非常相似。

首先对领域模型进行概述。列出正在移动的主要数据段，以及对这些数据执行的主要功能。我把这些写在我的笔记本上，很多时候，它只是一个名字，下面有3-5个项目符号。这个大纲可能是初始名称空间的一个很好的近似值，它应该指出一些关键的高级接口。

如果它看起来非常简单，那么我将为高级接口创建空函数，并开始填充它们。通常，每个高级函数都需要几个支持函数，当您构建整个接口时，您将发现共享更多代码的机会，因此您可以在进行过程中进行重构。

如果这看起来是一个更困难的问题，那么我将开始绘制数据结构和关键函数流的图表。通常情况下，最有意义的图表和概念模型将取决于您选择在特定设计中使用的抽象类型。例如，如果您为Swing GUI使用数据流库，那么使用依赖图将是有意义的，但是如果您正在编写一个处理关系数据库查询的服务器，那么您可能希望用图表示用于处理元组的代理池和流水线。我认为这些类型的模型和图表在向另一个开发人员传达程序是如何架构的方面也更具描述性。它们更多地显示了系统各个方面之间的功能连接，而不是由UML之类的东西传达的相当不特定的信息。