overview

为了标准模块对外提供正当的api，现整顿如下准则：

若干准则

作者对api负责。承当好用、不好用带来的后果。
负责迭代更新。

作者开发的api应该先满足作者的需要。

不以用户为核心开发api。用户能应用的api都是作者已开发的api。
作者决定开发哪些api。用户决定应用哪些api。
用户有使用权。用户能够抉择应用或不应用。能够提倡议。不可决定api。
此准则是“作者优先准则”的另一种表白。

每个api必须能够实现肯定性能。

每个api只实现一个性能。

这条很重要，然而我不晓得如何形容。

每个api能够有肯定重载能力。然而不应该适度重载。此准则相似“繁多准则”。

当api收到一些不影响运行的数据或通过解决后能够运行的数据时应该失常返回后果。

当有更严格的数据时应该优先应用此数据。
如：严格的数据类型、限定应用范畴的数据。

在某同一个实现后果上有多个api管制时，应该应用灵活性更大的数据去实现。

各api间应该缩小重叠管制。尽量做到每个api管制一个性能。减小多个api管制一个性能的状况。

命名api时应该做到见文知意。