لذا دخلت في هذا الموضوع العميق ومن الجنون كم كنت أعرف القليل عن ممارسات التوثيق والأطر، وكل ذلك لا يذكر أبدا في الوثائق الفعلية أو أي دورات كبيرة سترى عنها. arc42، نمذجة C4، وDiátaxis هي أساليب لم أر أشخاصا يطبقونها بشكل صريح. معظم قواعد الشيفرة التي رأيتها كانت تحتوي على توثيق عشوائي كفكرة ثانوية أو، كجانب آخر من الطيف، تم تبسيطها وتجريدها بالكامل من قبل كتاب تقنيين ذوي خبرة، لذا كان من المستحيل فهم تعقيد المنتج تحت السطح. ومع ذلك، أنا أعمل الآن على أداة التوثيق الوكيلي الخاصة بها، والتي يجب أن تطبق بعض هذه القواعد عمليا وتحافظ على مستندات متسقة لقواعد الشيفرة عالية السرعة وتكون متوافقة مع أي أنواع سير العمل التطويري، مع إمكانية معالجة مستودعات كاملة من الصفر وصيانتها لاحقا من خلال معالجة اختلافات git ذات الأصل العشوائي.