كتابة التعليمات البرمجية المستعارة - أفضل الممارسات؟ [مغلق]

Question

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

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

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

وشكرا مقدما.

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

Answer 1

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

وهناك أوقات عندما <لأ href = "http://www.google.co.uk/search؟q=uml+sequence+diagram&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en -GB: مسؤول والعميل = فايرفوكس واحد "يختلط =" noreferrer "> UML تسلسل مخطط أسرع من الكتابة كعملية عقلية لرسم ما يجب أن يحدث، وعندما، ولكن تلك التقنيات هما ما أعود إلى مرارا وتكرارا.

Answer 2

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

Answer 3

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

Answer 4

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

Answer 5

وأنا أيضا تجد من المفيد شبة الكود. نهجكم صفحتين يبدو جيدا. كنت قد ننظر أيضا إلى الفصيح <لأ href = "http://en.wikipedia.org/wiki/ Literate_programming "يختلط =" نوفولو noreferrer "> البرمجة . أنا غالبا ما تستخدم أسلوب LP بطرح أفكاري وأنا البرنامج، على الرغم من أنني لا عموما استخدام أداة LP.

Answer 6

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

وظننت أنني كسول جدا، أو مجرد ضدها لسبب ما ولكن بعد ذلك وجدت <لأ href = "http://www.codinghorror.com/blog/archives/001264.html" يختلط = "نوفولو noreferrer" > يرى آخرون نفس