Как найти подходящего человека для обзора функций API?

Question

Мы разрабатываем продукт, который предоставляет интерфейс API, поэтому другие разработчики могут использовать некоторые функции основного продукта.

Это уже реализовано и задокументировано.

Но я не уверен, что это очень полезно, и документация очень понятна для разработчиков.

Как мы можем найти людей для просмотра этой функции? Каким должен быть человек?

В каком-то смысле мы ищем владельца продукта для отдельных компонентов/компонентов. Является ли это возможным?

Answer 1

Было бы лучше всего найти программиста, который уже разработал некоторые известные рамки для данного языка.

Что, как полагают ваши пользователи, является релевантным. Я думаю, потому что вы не можете судить о каркасе, спросив произвольного программиста его об этом. Его ответ будет зависеть от его уровня знаний и личных методологий, в то время как API разрабатывается для более широкого населения (я предполагаю, что это ваш случай). Чтобы закончить этот момент, у моих твердых программистов, которые используют VB.NET, считают, что C# является хромым языком из-за «проблем», как вы не можете писать Button = «Text» на C# и позволить компилятору автоматически найти свойство по умолчанию для вас. Вы не хотите, чтобы такой человек оценивал ваши рамки.

Даже дизайнеры, работающие на разных языках, могут быть полезны, поскольку более широкие используемые API-интерфейсы должны быть реализованы с помощью известных шаблонов программирования, с которыми люди уже знакомы.

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. Сделайте проект для этого, а затем получите отзывы от разработчиков как часть проекта.

Вы, вероятно, хотите, чтобы люди, которые могут общаться на своем родном языке ...

Кстати, ожидая, пока он не все документированы и реализованы, вероятно, не самое лучшее время, чтобы рассмотреть его ... было бы было намного лучше сделать обзор перед реализацией.