ما هي المقبولة عموما رمز تنسيق المبادئ التوجيهية ؟

Question

وفقا ماكول نموذج الجودة, المنتج تنقيح هي واحدة من ثلاث دعائم رئيسية لوصف سمات الجودة من منتج البرنامج.تحت المنتج تنقيح المنظور ، الصيانة, القدرة على العثور على وإصلاح الخلل, هو التعرف على مفتاح عامل النوعية التي تؤثر على القدرة على مراجعة البرنامج.

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

ما المقبولة عموما ، اللغة الملحد رمز تنسيق المبادئ التوجيهية هل عملت مع ذلك تعظيم مبرمج الكفاءة والفعالية في قانون تنقيح العملية ؟

Answer 1

أفضل المبادئ التوجيهية عملت مع الاتساق.على مر السنين لقد استعملت الكثير من أنماط مختلفة مع فرق مختلفة ...أفضل النتائج رأيته هو عندما يكون الفريق كله تضطر إلى استخدام نفس النمط ، بغض النظر عن نمط ما هو عليه :-)

Answer 2

لدي بعض الأفكار حول بعض مفاهيم الملحد:

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

2.) صيانة إصلاحات ، مرجع عيب عدد تتبع في التعليق-على افتراض أن لديك نوعا من الخلل نظام تتبع.هذا يجعل من السهل على أي شخص المحافظة على العمل الخاص بك إلى معرفة لماذا تم تغيير رمز بين تنقيح واحد آخر.

3.) اللغات التي تدعم ذلك ، يتم تعريف المتغيرات في أقرب وقت ممكن إلى أول استخدام.

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

قد ترغب في إلقاء نظرة على ستيف ماكونيل هو رمز كاملة.انها كاملة من الأفكار الجيدة التي ينبغي أن تكون قابلة للتطبيق في ما يقرب من أي حالة التنمية بغض النظر عن لغة البرمجة.

Answer 3

الاتساق هو المفتاح.كتابة المبادئ التوجيهية في مكان ما و تتطلب التوافق.

رمز التنسيق لا يستحق القلق حول ولا يتجادلون حول.مجرد جعل بعض القواعد والالتزام بها.

Answer 4

أنا أتفق مع جويل.وهناك العديد من الأمثلة على غرار هناك ؛ معظم جيدة.بعض ليست مفيدة مثل الآخرين (منهج المجرية?) بعد الآن.بيت القصيد هو الاتساق ، على الرغم من.طالما مطور جديد في فهم رمز الحق بعيدا بدلا من أن يعتاد كل فرد المطور نمط الشخصية, يعمل.

تبديل المعايير كل سنة أو نحو ذلك ربما هو فكرة سيئة.

Answer 5

أنا أتفق مع جويل الصيانة ترتفع إلى حد كبير عندما يكون لديك الاتساق داخل المؤسسة الخاصة بك.إذا كنت الانضمام إلى فريق آخر المنحدر الوقت هو أقل من ذلك بكثير إذا كان كل شيء له نفس الشكل والمظهر الحالي لأنه لا يمكن قراءة رمز أسرع بكثير w/كل "الداخلية سياق التحول" أن "حتى أنها تستخدم mVar بدلا من _var" / الخ

Answer 6

أحد المعايير لدينا متغير "التقديم".حتى جئت إلى هنا كنت في الغالب مكتوبة منفردا حتى لا تقلق بشأن ذلك.

نحن "مطلوب" إلى اسم المتغيرات مع البادئات التي تشير إلى ما هي عليه.لذا تعرف على الفور عندما تبحث في dpVarName أنه مؤشر إلى ضعف ، lVarName طويل int.

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