如何找到合适的API功能审核人员？

Question

我们正在开发一个提供API接口的产品，以便其他开发者可以使用主产品的一些功能。

这已经实施并记录在案。

但我不确定这是否非常有用，并且文档对于开发人员来说非常清晰。

我们如何找到人来评论这个功能？应该是什么样的人？

从某种意义上说，我们正在寻找单个功能/组件的产品负责人。是否可以？

Answer 1

这将是最好找一个程序员一个已经设计了相关语言的一些已知的框架。

你的用户认为是irelevent我认为，监守你不能问任意程序员一下他的toughts判断有关框架。他的答案将取决于他的知识和个人的方法的水平，而API被设计为更广泛的人群（我假设这是你的情况下）。要完成这一点，在使用VB.NET认为C＃是瘸子语言监守的像你这样的“问题”在C＃中不能写按钮=“TEXT”，让编译器自动查找默认属性我对你的公司的程序员。你不希望这样的人判断你的框架。

即使设计师在不同的语言经验可能会有所帮助，因为广泛使用的API应该与众所周知的编程模式的人都与已经familar的帮助下实现。

Answer 2

找人谁是不与您的产品经验，使一些示例代码或您的API的参考实现一个客户。然后，他们会得到一个良好的意识，其中的文档不足或API需要改进。这可能是一个承包商，或一个新的开发（好办法让他们加快速度）。

Answer 3

首先，如果你正在开发供他人使用的API，我建议你读一本书，像：的 http://www.amazon.com/Framework-Design-Guidelines-Conventions-Development/dp/0321545613

经过这些规则将避免大量的可用性问题与你的界面之前任何审查是必要的。

二，运行有几个目标的开发商，那些谁很可能会利用这个API的，但在此之前还没有见过它的可用性研究。把它们在系统中的前，给他们一些任务，然后看他们如何去搞清楚如何做到这一点。你需要做出改进他们的痛点会告诉你。

Answer 4

调查您的最终用户并找出哪些用户正在使用您的 API 与您的软件进行交互。然后，您可以对这些用户进行调查，了解他们对 API 中提供的各种功能以及文档的易用性和清晰度的看法。

Answer 5

每个API有一定的目标受众（即客户开发集成到您的产品）。从这个角度来看这将是最好的摆脱这个群体成员的反馈。你可以建立一些即早期访问计划，或提供一些公共测试版。

如果您有没有这样的观众（即你正在开发一个产品，这是尚未公开API），我会建议做“可用性测试”的一些王 - 即选择一个开发商的约目标受众的技能，并给他一些任务涉及的API使用。然后从他那里得到反馈。

Answer 6

如果我处于您的位置，我会开始编写示例应用程序，并进行演示以引导人们完成这些步骤或进行其他类似的练习。它不如从用户那里得到反馈，但它可以解决一些问题。

另一个（可能是坏的）想法是在 elance/guru 网站上花钱，并提出一个您认为代表用户将如何使用 API 的示例应用程序/功能。为此制定项目，然后作为项目的一部分从开发人员那里获得反馈。

您可能需要能够用您的母语进行交流的人......

顺便说一句，等到全部记录并实施可能不是审查它的最佳时机......在实施之前进行审查会好得多。