Как найти подходящего человека для проверки функций 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.Создайте проект для этого, а затем также получите обратную связь от разработчиков как часть проекта.

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

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