Comment on page

تنسيق الكود

يجب أن تحتوي أمثلة ووحدات Terraformعلى توثيق لشرح الخصائص التي تقدمها وكيفية استعمالها
كل الروابط في ملف README.md يجب أن تكون مطلقة لجعل موقع Terraform Registry يعرضها بشكل صحيح
يمكن أن يحتوي التوثيق على رسومات تم إنشاؤها باستخدام mermaid أو مخططات تم إنشاؤها باستخدام cloudcraft.co.  
قم باستعمال Terraform pre-commit hooks للتأكد من أن الكود صالح، ومنسق بشكل صحيح، وموثق تلقائيًا قبل دفعه إلى Git واستعراضه من قبل البشر.  
التوثيق
التوثيق مولداً تلقائياً
إن pre-commit هو إطار عمل لإدارة وصيانة pre-commit hooks متعددة اللغات، مكتوبة بلغة بايثون وهي أداة قوية للقيام ببعض المهام بشكل أتوماتيكي على جهاز المطور قبل الدفع بالكود إلى git repository. تستعمل عادةً لتشغيل linters ولتنسيق الكود ( انظر إلى supported hooks)
مع ملفات Terraform يمكننا استعمال pre-commitلتنسيق الكود والتحقق منه بالإضافة إلى تعديل التوثيق
تحقق من pre-commit-terraform repository ومن  terraform-aws-vpc الذي يقوم باستعماله
أداة terraform-docs
إن terraform-docs هي أداة تقوم بتوليد التوثيق من وحدات Terraform وتولد أشكال مختلفة، يمكنك أن تشغلها يدوياً (بدون pre-commit hooks) أو تستعمل إطار عمل pre-commit-terraform hooks لجعل التوثيق يتكون أتوماتيكياً.
@todo: Document module versions, release, GH actions
الموراد
1.​pre-commit framework homepage​
2.​Collection of git hooks for Terraform to be used with pre-commit framework​
3.Blog post by Dean Wilson: pre-commit hooks and terraform - a safety net for your repositories​

قواعد التسمية

الأسئلة الأكثر تكراراً

Last modified 7mo ago