دردشة سريعة عن الـ RFC 💡
.
.
في أوقات كتير بيكون عندك فكرة حلوة — ممكن تكون تحسين في الأداء، refactor، أو feature جديدة —
بس أول ما تحاول تشرحها للتيم، الحوار بيبقى عشوائي، والناس بتفهم نص الفكرة أو ترفضها قبل ما تستوعبها أصلًا...

علشان كده التيمات في الشركات الكبيرة والمتوسطة بتستخدم حاجة اسمها RFC – Request For Comments،
ودي ببساطة طريقة منظمة بتخليك تشرح فكرتك بالتفصيل، وتخلي الكل يشارك رأيه قبل التنفيذ.

———

📌 يعني إيه RFC؟

الـ RFC عبارة عن مستند مكتوب بيشرح فيه صاحب الفكرة كل حاجة عن الـ feature أو التغيير اللي عايز يعمله:
من الـ context، والـ problem اللي بيحاول يحلها، لحد الـ proposed solution، والـ alternatives، والـ trade-offs.

الهدف إنك تشارك التفكير بتاعك مع التيم علشان الكل يقدر يناقش الفكرة من وجهات نظر مختلفة — هندسية، product، أو حتى business.

———

🎯 ليه مهم نكتب RFC؟

فيه 3 أسباب رئيسية بتخلي الـ RFCs مهمة جدًا في أي تيم:

1- بتمنع القرارات الفردية العشوائية:
بدل ما أي حد يغيّر في الـ codebase أو الـ system architecture بمزاجه، الـ RFC بتخلي القرار جماعي ومدروس.

2- بتوثّق القرارات التقنية:
بعد 6 شهور لما حد يسأل “ليه اخترنا نستخدم Redis هنا؟”، تقدر ترجع لـ RFC وتشوف reasoning واضح بدل ما تعتمد على الذاكرة.

3- بتحسّن التعاون بين الفرق:
الـ frontend، backend، DevOps... الكل بيبقى عارف الاتجاه العام للـ system وبيشارك في القرار.

———

إزاي تكتب RFC محترم؟ 🤔

الـ structure مش ثابت، بس فيه فورمات متعارف عليه وبيخلي الـ RFC واضح ومنطقي.

📍 الـ Title + Summary
ابدأ بعنوان بسيط وواضح يشرح هدف الـ RFC.

مثلًا:

RFC: Introduce caching layer for product API

وبعدها اعمل Summary صغير بيشرح في جملة أو اتنين الفكرة العامة:

We propose adding a Redis-based caching layer to reduce response time for frequently accessed endpoints.

📍 الـ Context / Background
احكي باختصار الـ situation الحالي وليه محتاجين التغيير.

مثلًا:

Currently, our product endpoints are hitting the database directly, leading to high latency during peak hours.

الفكرة إنك تدي القارئ صورة كاملة عن المشكلة قبل ما يدخل في الحل.


📍 الـ Problem Statement
وضح المشكلة الأساسية اللي بتحاول تحلها بالأرقام لو أمكن.

مثلًا:

Average response time increased from 300ms to 900ms under load.

دي بتخلي الـ RFC منطقي ومبني على data.


📍 الـ Proposed Solution
اشرح الـ approach اللي ناوي تستخدمه، ليه اخترته، وإزاي هيشتغل.

مثلًا:

We'll use Redis to cache product data for 5 minutes. The cache will be invalidated on product update events.

ممكن كمان تضيف diagram بسيط أو pseudo code لو محتاج توضح flow معين.


📍 الـ Alternatives Considered
بيوضح إنك مش اخترت الحل عشوائي.

مثلًا:

Considered using in-memory cache, but it doesn’t scale horizontally. Redis fits better for distributed systems.

📍 الـ Trade-offs
قول بصراحة إيه العيوب اللي ممكن تحصل.

Cache invalidation adds complexity and increases operational overhead.

📍 الـ Impact / Risks
قول إيه اللي ممكن يتأثر في الـ system.

Adding caching could lead to stale data if invalidation fails.

📍 الـ Open Questions
ممكن تسيب في الآخر شوية أسئلة مفتوحة علشان التيم يناقشها:

Should we cache all products or only top 100 requested ones?

📍 الـ Next Steps
اختصر إيه اللي هيحصل بعد الموافقة.

If approved, implementation will start in sprint 25, and metrics will be collected after deployment.

———

💡 نصائح مهمة وأنت بتكتب RFC:

- خليك واضح وبسيط، بلاش مصطلحات تقيلة من غير داعي.
- استخدم bullet points علشان الناس تقرأ بسهولة.
- لو فيه diagrams أو code snippets، ضيفهم علشان تسهل الفهم.
- خليك مرن في النقاش... الهدف مش إن فكرتك تتنفذ، الهدف إن نختار أفضل حل.

———

مش مهم تكتب RFC مثالية من أول مرة، المهم إنك تبدأ، ومع الوقت هتتعلم إزاي توصل فكرتك بأوضح وأقوى طريقة ممكنة 🔥

———

وفقكم الله لكل خير 🌿