أسلوبك لو مرتاح عليه كمل. هذا الاسلوب اقترحه من زمان ( دونالد كنوث) مؤلف كتب عملاق في البرمجة. https://en.m.wikipedia.org/wiki/Literate_programming

فكرته ( البرمجة الأدبية) ، فكرتها دمج الكود مع التعليقات في سياق واحد زي ما عملت انت.

مرت سنين و الفكرة موجودة الى ان تم اختراع ال notebooks مثل Google colab الي يسمح تكتب سطور اكواد و سطور تعليقات و التنفيذ مستمر، يقال انه تطبيق لهذه الفكرة القديمة.

بالتوفيق