كيفية العثور على الشخص المناسب لمراجعة ميزة API؟

Question

نحن نقوم بتطوير منتج يوفر واجهة API، لذلك يمكن للمطورين الآخرين استخدام بعض وظائف المنتج الرئيسي.

تم تنفيذ هذا بالفعل وتوثيقه.

لكنني لست متأكدا من أن هذا مفيد للغاية، والوثائق واضحة جدا للمطورين.

كيف يمكننا العثور على أشخاص لمراجعة هذه الميزة؟ ما نوع الشخص يجب أن يكون؟

بمعنى ما، نحن نبحث عن مالك المنتج لميزة / مكون واحد. هل هو ممكن؟

Answer 1

سيكون من الأفضل العثور على مبرمج قام بالفعل بتصميم بعض إطارا معروفا للغة المعنية.

ما يعتقده المستخدمون الخاص بك هو Irelevent وأعتقد أنه لا يمكنك الحكم على الإطار عن طريق طرح مبرمج تعسفيته. تعتمد إجابته على مستواه من المنهجيات والمنهجيات الشخصية بينما تم تصميم واجهة برمجة التطبيقات لسكان أوسع (أفترض أن هذا هو حالتك). لإنهاء هذه النقطة، في هذه النقطة، تعتقد مبرمجتي الشريطية التي تستخدم vb.net أن C # هي لغة عرجاء أصبحت "مشاكل" مثلك لا يمكنك كتابة زر = "نص" في C # واسمح لك الترجمة تلقائيا العثور على الخاصية الافتراضية لك. أنت لا تريد أن يحكم هذا الشخص على الإطار الخاص بك.

قد يكون حتى المصممين الذين يعانون من ذوي الخبرة بلغات مختلفة من المساعدة لأن وينبغي تنفيذ واجهات برمجة التطبيقات المستخدمة على نطاق أوسع بمساعدة أنماط البرمجة المعروفة من الناس بالفعل.

Answer 2

احصل على شخص ليس من ذوي الخبرة في منتجك لإجراء بعض التعليمات البرمجية أو التنفيذ المرجعي لعميل API الخاص بك. ثم سيحصلون على شعور جيد بمكان أن تكون الوثائق ناقصة أو يحتاج إلى تحسين API. يمكن أن يكون هذا مقاولا، أو مطور جديد (طريقة جيدة للحصول عليها السرعة).

Answer 3

أولا، إذا كنت تقوم بتطوير واجهة برمجة تطبيقات لاستخدامها من قبل الآخرين، فسوف أوصي بقراءة كتاب مثل: http://www.amazon.com/framework-design-guedlines-conventions-development/dp/0321545613.

بعد هذه القواعد ستتجنب عددا كبيرا من مشكلات قابلية الاستخدام مع واجهةك قبل أي مراجعة ضرورية.

ثانيا، قم بتشغيل دراسة قابلية للاستخدام مع عدد قليل من المطورين المستهدفين، أولئك الذين من المرجح أن يستخدموا هذا API، لكنهم لم يروه من قبل. ضعهم أمام النظام ومنحهم بعض المهام، ثم شاهدوا كيف يذهبون حول معرفة كيفية القيام بذلك. سوف تخبرك نقاط الألم الخاصة بهم حيث تحتاج إلى إجراء تحسينات.

Answer 4

استدعاء المستخدمين النهائيين الخاص بك ومعرفة أي منها تستخدم واجهة برمجة التطبيقات الخاصة بك للتفاعل مع البرنامج الخاص بك. يمكنك بعد ذلك مسح هؤلاء المستخدمين والحصول على آرائهم حول الميزات المختلفة التي تقدمها في واجهة برمجة التطبيقات الخاصة بك مع سهولة الاستخدام ووضوح المستندات الخاصة بك.

Answer 5

يحتوي كل API على بعض الجمهور المستهدف (أي العملاء الذين يقومون بتطوير التكاملات على المنتج الخاص بك). من وجهة النظر هذه، سيكون من الأفضل الحصول على ردود الفعل من أعضاء هذا الجمهور. يمكنك إنشاء أي بعض برنامج الوصول المبكر، أو شحن بعض betas العام.

إذا لم يكن لديك مثل هذا الجمهور (أي فإنك تقوم بتطوير واجهة برمجة التطبيقات الخاصة بمنتج، وهو ما لم يكن عاما بعد)، أود أن أقترح القيام ببعض ملك اختبار قابلية الاستخدام "- أي اختيار مطور مهارة الجمهور المستهدف تقريبا وتعطيه بعض المهام تنطوي على استخدام API. ثم الحصول على ردود الفعل منه.

Answer 6

إذا كنت في حذائك، فسأبدأ في كتابة تطبيقات نموذجية وإما القيام بعرض عرض تقديمي للمشي الناس على الرغم من الخطوات أو بعض التمرينات الأخرى المشابهة. إنها ليست جيدة مثل الحصول على تعليقات من المستخدمين، ولكن يمكن أن تهز بعض القضايا.

هناك فكرة أخرى (ربما سيئة) هي إنفاق الأموال على مواقع ELANCE / GURU وتصل إلى نموذج / وظيفة عينة تعتقد أنه ممثل كيف سيستخدم المستخدمون API. اجعل المشروع لذلك، ثم احصل على تعليقات من المطورين كجزء من المشروع.

ربما كنت تريد أن تتواصل الأشخاص الذين يمكنهم التواصل في لغتك الأم ...

بالمناسبة، انتظار حتى يتم توثيقها وتنفيذها هو أفضل وقت لاستعراضه ... كان من الأفضل القيام به بشكل أفضل للقيام بالمراجعة قبل التنفيذ.