Show notes are at https://stevelitchfield.com/sshow/chat.html
…
continue reading
المحتوى المقدم من Ross Hunter and The New Best Practices. يتم تحميل جميع محتويات البودكاست بما في ذلك الحلقات والرسومات وأوصاف البودكاست وتقديمها مباشرة بواسطة Ross Hunter and The New Best Practices أو شريك منصة البودكاست الخاص بهم. إذا كنت تعتقد أن شخصًا ما يستخدم عملك المحمي بحقوق الطبع والنشر دون إذنك، فيمكنك اتباع العملية الموضحة هنا https://ar.player.fm/legal.
Player FM - تطبيق بودكاست
انتقل إلى وضع عدم الاتصال باستخدام تطبيق Player FM !
انتقل إلى وضع عدم الاتصال باستخدام تطبيق Player FM !
Code Comments
MP3•منزل الحلقة
Manage episode 197174641 series 1981042
المحتوى المقدم من Ross Hunter and The New Best Practices. يتم تحميل جميع محتويات البودكاست بما في ذلك الحلقات والرسومات وأوصاف البودكاست وتقديمها مباشرة بواسطة Ross Hunter and The New Best Practices أو شريك منصة البودكاست الخاص بهم. إذا كنت تعتقد أن شخصًا ما يستخدم عملك المحمي بحقوق الطبع والنشر دون إذنك، فيمكنك اتباع العملية الموضحة هنا https://ar.player.fm/legal.
Outline
- Definition of comments: “Metadata in source code that describe what code fails to communicate. Some languages and frameworks opt to use the mechanism of comments as formal documentation for code, but these two concepts should be separated.“
- Strive to make code self-documenting
- Formal Documentation vs. Code Comments
- Using tests to document your code
- Considering strong types as a type of documentation
- Docstring Tests
- The value of documenting types
- Worthless comments should be avoided
- Don’t use comments to “vent” your emotions
Links
- Python doctest
- JSON API Expectations Semantic expectation helpers for JSON API testing using RSpec and Airborne.
9 حلقات
MP3•منزل الحلقة
Manage episode 197174641 series 1981042
المحتوى المقدم من Ross Hunter and The New Best Practices. يتم تحميل جميع محتويات البودكاست بما في ذلك الحلقات والرسومات وأوصاف البودكاست وتقديمها مباشرة بواسطة Ross Hunter and The New Best Practices أو شريك منصة البودكاست الخاص بهم. إذا كنت تعتقد أن شخصًا ما يستخدم عملك المحمي بحقوق الطبع والنشر دون إذنك، فيمكنك اتباع العملية الموضحة هنا https://ar.player.fm/legal.
Outline
- Definition of comments: “Metadata in source code that describe what code fails to communicate. Some languages and frameworks opt to use the mechanism of comments as formal documentation for code, but these two concepts should be separated.“
- Strive to make code self-documenting
- Formal Documentation vs. Code Comments
- Using tests to document your code
- Considering strong types as a type of documentation
- Docstring Tests
- The value of documenting types
- Worthless comments should be avoided
- Don’t use comments to “vent” your emotions
Links
- Python doctest
- JSON API Expectations Semantic expectation helpers for JSON API testing using RSpec and Airborne.
9 حلقات
كل الحلقات
×مرحبًا بك في مشغل أف ام!
يقوم برنامج مشغل أف أم بمسح الويب للحصول على بودكاست عالية الجودة لتستمتع بها الآن. إنه أفضل تطبيق بودكاست ويعمل على أجهزة اندرويد والأيفون والويب. قم بالتسجيل لمزامنة الاشتراكات عبر الأجهزة.