المساهمة

المساهمات مرحّب بها جدًا. وآمل أن يصبح هذا بيتًا رائعًا لأدلة تعلّم Go عبر كتابة الاختبارات. فكّر في إرسال PR أو إنشاء issue، ويمكنك فعل ذلك من هنا.

ما نبحث عنه

• تعليم ميزات Go (مثل أشياء كهذه: if وselect والـ structs والـ methods وغيرها).
• عرض وظائف مثيرة للاهتمام داخل المكتبة القياسية. وإظهار كم هو سهل اتباع TDD لخادم HTTP مثلًا.
• إظهار كيف يمكن لأدوات Go، مثل قياس الأداء وكاشفات التسابق (race detectors) وغيرها، أن تساعدك في الوصول إلى برمجيات رائعة.

وإذا لم تكن واثقًا من قدرتك على تقديم دليلك الخاص، فإن إنشاء issue لشيء تريد تعلّمه يظل مساهمة قيّمة.

⚠️ احصل على تغذية راجعة سريعة للمحتوى الجديد ⚠️

• يعلّمنا TDD أن نعمل تكراريًا ونحصل على تغذية راجعة، وأنصحك بشدة أن تفعل الشيء نفسه إن أردت المساهمة
  • افتح PR بأول اختبار وتنفيذ لديك، وناقش أسلوبك حتى أستطيع تقديم تغذية راجعة وتصحيح المسار
• هذا مفتوح المصدر بالطبع، لكن لديّ آراء قوية في المحتوى. فكلما تحدثت إليّ مبكرًا كان أفضل.

دليل الأسلوب

• عزّز دورة TDD دائمًا. وألقِ نظرة على قالب الفصل.
• التركيز على التكرار على الوظائف المدفوعة بالاختبارات. فمثال Hello, world يعمل جيدًا لأننا نجعله تدريجيًا أكثر تطورًا ونتعلّم تقنيات جديدة مدفوعين بالاختبارات. على سبيل المثال:
  • Hello() <- كيفية كتابة الدوال وأنواع الإرجاع.
  • Hello(name string) <- الوسائط والثوابت.
  • Hello(name string) <- القيمة الافتراضية “world” باستخدام if.
  • Hello(name, language string) <- switch.
• حاول تقليل مساحة المعرفة المطلوبة.
  • من المهم التفكير في أمثلة تُبرز ما تحاول تعليمه دون إرباك القارئ بميزات أخرى.
  • مثلًا، يمكنك تعلّم الـ structs دون فهم المؤشرات.
  • الإيجاز هو الملك.
• اتبع دليل أسلوب Code Review Comments. فمن المهم وجود أسلوب متسق في جميع الأقسام.
• ينبغي أن يحتوي قسمك على تطبيق قابل للتشغيل في النهاية (مثل package main فيه دالة main) ليتمكن المستخدمون من رؤيته أثناء العمل والتلاعب به.
• ينبغي أن تنجح كل الاختبارات.
• شغّل ./build.sh قبل رفع PR.