أمثلة محددة على وثائق رشيقة؟[مغلق]

Question

في جواب السؤال وثائق للمشروع؟, أجاب كريس بالانس ذلك "قصص المستخدم" و"المخطط المتوقف" هما النوعان الأكثر فائدة من وثائق المشروع للمطور.

سؤالي هو، هل تعرف أي أمثلة جيدة يمكنني رؤيتها (على سبيل المثال على الإنترنت أو في كتاب) لهذا النوع من التوثيق؟

إذا أمكن سأكون سعيدًا برؤية العديد من الأمثلة، بما في ذلك:

• أمثلة صغيرة/قصيرة/بسيطة
• أمثلة كبيرة/طويلة/معقدة
• أمثلة مشهورة
• أمثلة عالية الجودة

لا أجد هذا موضوعًا سهلاً لـ Google بالنسبة إلى:أجد الكثير مكتوبًا عنها، ولكن القليل من الأدلة التي تظهرها.

Answer 1

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

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

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

امل ان يساعد!

Answer 2

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

http://aliستير.cockburn.us/Earned-value+and+burn+charts

(على الرغم من أنني أكرر توصية الملصق السابق لعمل مايك كوهن).

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

إذا كنت تعمل على مشروع "صغير" وفقًا لأي من التعريفات العشرة للصغير، فقد تكون جيدًا مع القصص الخفيفة جدًا.إليك مثال، مرة أخرى من موقع كوكبيرن:

http://aliستير.cockburn.us/Examples+of+ultra-light+use+cases

Answer 3

تعرض هذه المقالة اثنين من لوحات المهام الفعلية.http://www.mountaingoatsoftware.com/task-boards

Answer 4

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

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

هذا بالإضافة إلى توقف الإصدار وتوقف السباق.

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

Answer 5

فكر في قراءة "النمذجة الرشيقة" لـ Ambler.لقد قدم حجة قوية جدًا حول السبب الذي يجعل إنشاء الكثير من UMLs الكاملة فكرة سيئة إلى حد ما، ويعطي بعض الأمثلة الجيدة.