إذا كانت شركتك تبيع منتجاً يستخدمه المطورون، وتريد أن يجربه أكبر عدد منهم ويكملوا التجربة، فهذا المقال لك. وهو مكتوب للمؤسس ومدير المنتج ومدير التسويق، ولا يحتاج أن تكون مبرمجاً.
ستعرف فيه لماذا صفحة واحدة في التوثيق تسمى صفحة البداية Quickstart أهم من صفحتك الرئيسية، وماذا تضع فيها، وكيف تقيسها، وكيف تمنعها من أن تصبح قديمة وخاطئة.
وفي أول مقال من هذه السلسلة رأينا أن التوثيق التقني Documentation هو أول مصدر يتعلم منه المطورون، بنسبة 67.8% بحسب استبيان Stack Overflow لعام 2025. والتوثيق هو الصفحات التي تشرح كيف يستخدم المنتج.
المواضيع في سلسلة التسويق للمطورين DevRel:
- التسويق للمطورين Developer Marketing: لماذا يتجاهلون الإعلانات؟
- علاقات المطورين DevRel: ماذا يفعل الفريق وكيف يقاس؟
- التوثيق أداة تسويق: صفحة البداية Quickstart التي تقنع (الموضوع الحالي)
- المصادر المفتوحة قناة للنمو: من المستخدم إلى العميل
دليلالتسويق للمطورين Developer Marketing: لماذا يتجاهلون الإعلانات؟لماذا لا يقتنع المطور بالإعلان، وما الذي يجعله يجرب أداة ويوصي بشرائها، بأرقام استبيان Stack Overflow 2025 وأمثلة حقيقية.
دليلعلاقات المطورين DevRel: ماذا يفعل الفريق وكيف يقاس؟ماذا يفعل فريق علاقات المطورين DevRel، وأين تضعه في شركتك، وكيف تقيس عمله، ومتى توظف أول شخص فيه.باختصار Quick Summary
لماذا تهم: هي صفحة الهبوط الحقيقية لمنتج المطورين. وفيها يقرر خلال دقائق هل يكمل أم يجرب منافسك.
أهم رقم: الوقت من إنشاء الحساب حتى أول نتيجة ناجحة. والهدف دقائق قليلة.
أهم قاعدة: هدف واحد، وخطوات قليلة، وتجربة دون دفع.
أكبر خطر: أن يتغير المنتج ولا تتغير الصفحة. لذلك تختبر مع كل إصدار، ولها مالك واحد بالاسم.
لماذا صفحة البداية تسويق؟
في أغلب المنتجات يبدأ طريق العميل بإعلان، ثم صفحة هبوط Landing Page، ثم نموذج تسجيل.
أما المطور فطريقه مختلف. يسمع عن المنتج من زميل، أو يجده وهو يبحث عن حل لمشكلة. ثم يفتح صفحة البداية ليرى كم يحتاج من الوقت ليجربه، ثم يقرر.
والصفحة الرئيسية التي صرف عليها فريق التسويق أسابيع قد لا يراها أبداً. لذلك صفحة البداية هي صفحة الهبوط الحقيقية: لها هدف واحد، ولها نسبة تحويل، ولها مكان يخرج منه الزوار.
الخروج الصامت
الفرق المهم أن الخروج من صفحة البداية صامت.
الزائر الذي لا تقنعه صفحة هبوط يخرج، وهذا متوقع. أما المطور الذي يتبع الخطوات فيرى خطأ، فقد اقتنع ثم فشل. وهذه أسوأ تجربة يمكن أن يأخذها عن منتجك، وسيتذكرها عندما يسأله زميل عنه.
مثال: شركة غيرت شكل مفتاح الاختبار في منتجها، ونسيت أن تعدل صفحة البداية. فصار كل مطور جديد يتبع الصفحة يرى رسالة خطأ. بعضهم سأل الدعم الفني، ولكن لا أحد يعرف كم مطوراً أغلق الصفحة وجرب منافساً دون أن يخبر أحداً.
هذا العدد المجهول هو التكلفة الحقيقية لصفحة بداية معطلة.
مثال حقيقي: صفحة لم تراجع
صفحة تثبيت برنامج Mixpost في توثيقه الرسمي تطلب من القارئ تشغيل قاعدة بيانات من نسخة جاهزة على موقع Docker Hub.
وصفحة هذه النسخة على Docker Hub تبين أن آخر تحديث لها كان في 18 يناير 2023. أي أن كل من ينسخ الخطوات كما هي يشغل قاعدة بيانات لم تصلها تحديثات منذ قرابة ثلاث سنوات.
والمشروع نفسه نشط وجيد. ولكن الصفحة التي يقرؤها كل مستخدم جديد لم يراجعها أحد.
المصدر: صفحة تثبيت Mixpost، وصفحة النسخة على Docker Hub، كما فتحناهما في 25 أكتوبر 2026.
أنواع التوثيق الأربعة Diátaxis
أكثر خطأ نراه في التوثيق هو خلط الأنواع. مثلاً صفحة بداية فيها شرح نظري طويل، فلا يجد القارئ ما جاء من أجله.
وإطار Diátaxis يقسم التوثيق إلى أربعة أنواع، لكل نوع حاجة مختلفة:

| النوع | لمن | مثال |
|---|---|---|
| الدرس Tutorial | القارئ الجديد، يأخذه خطوة بخطوة حتى ينجح في شيء صغير | صفحة البداية |
| دليل المهمة How-to Guide | من يعرف المنتج ويريد تنفيذ مهمة محددة | «كيف أسترد مبلغاً» |
| المرجع Reference | من يحتاج معلومة دقيقة أثناء العمل | قائمة بكل خيار في المنتج ومعناه |
| الشرح Explanation | من يريد أن يفهم لماذا صمم المنتج هكذا | صفحة عن تصميم النظام |
القاعدة العملية: لا تضع الشرح أو الخيارات الإضافية في صفحة البداية. كل فقرة لا يحتاجها القارئ لينجح الآن فرصة ليتوقف. ضع بدلاً منها رابطاً في آخر الصفحة.
وقد يسأل أحد: أليس الأفضل أن يفهم المطور النظام قبل أن يستخدمه؟ والإجابة أن الفهم يأتي بعد النجاح، لا قبله. من نجح في أول تجربة صار عنده سبب ليقرأ الشرح.
المصدر: موقع إطار Diátaxis.
ماذا تفعل صفحات البداية المعروفة؟
فتحنا صفحات البداية في ثلاث شركات يعرفها أغلب المطورين في 25 أكتوبر 2026، وهذا ما وجدناه:
| ما في الصفحة | Stripe (الدفع) | Twilio (الرسائل) | Supabase (قاعدة البيانات) |
|---|---|---|---|
| الهدف | صفحة دفع تعمل على موقعك | إرسال رسالة SMS واستقبالها والرد عليها | تطبيق صغير يقرأ من قاعدة البيانات |
| اختيار لغة البرمجة | نعم | نعم، ثماني لغات | صفحة مستقلة لكل لغة أو إطار |
| الخطوات | جزءان، في كل منهما خطوات صغيرة | المتطلبات، ثم التسجيل، ثم الإرسال، ثم الاستقبال | ثماني خطوات مرقمة |
| شرح السبب في الخطوات الحساسة | نعم، مثل لماذا لا يظهر المفتاح السري للزائر | نعم، مثل أن المفتاح السري يظهر مرة واحدة فاحفظه | نعم، مثل تفعيل الحماية على الجدول قبل فتحه |
| تجربة دون دفع | مفاتيح بيئة الاختبار Sandbox | حساب تجريبي ورقم افتراضي | مشروع على الخطة المجانية |
| اختصار | تنزيل مشروع جاهز | زر لنسخ الصفحة كنص | زر يملأ الأوامر في المحرر مباشرة |
| للذكاء الاصطناعي | زر Ask AI، وملف llms.txt | قسم Build with AI، وملف llms.txt | نص جاهز لمساعد البرمجة، وملف llms.txt |
الصفحات الثلاث تتفق في أربعة أشياء لا علاقة لها بالتصميم:
- هدف واحد واضح من أول سطر.
- القارئ يختار لغة البرمجة التي يعرفها.
- تجربة دون بطاقة ائتمان.
- جملة قصيرة تشرح السبب عند كل خطوة حساسة أمنياً.
والملاحظة الأهم: الصفحات الثلاث مصممة حول رقم واحد، هو الوقت حتى أول نتيجة Time to First Call. كل شيء فيها إما يقصر هذا الوقت، أو يمنع خطأ يطيله. وما لا يخدم هذا الرقم غير موجود أصلاً.
قواعد صفحة البداية التي تقنع
الشكل التالي يبين أجزاء صفحة البداية بالترتيب الذي يقرؤه المطور، ثم نشرح كل جزء:

- هدف واحد في أول سطر: مثل «سترسل أول رسالة خلال خمس دقائق». المطور يقرر من السطر الأول هل هذه الصفحة لمشكلته.
- المتطلبات بأرقام الإصدارات: مثل «Python من 3.8 إلى 3.13» كما تفعل Twilio، وليس «Python مثبت». المطور الذي يكتشف في الخطوة الخامسة أن نسخته لا تعمل يلوم منتجك، لا جهازه.
- خطوات كاملة تنسخ وتعمل: لا تكتب «عدل حسب بيئتك». القيمة الوحيدة التي يغيرها القارئ هي مفتاحه.
- النتيجة المتوقعة بعد كل خطوة: ما سيراه القارئ، حتى يعرف أنه على الطريق الصحيح.
- سبب قصير في الخطوة الحساسة: الدرس الذي يعلم طريقة غير آمنة ينتقل كما هو إلى المنتج الحقيقي.
- تجربة دون دفع: وضع اختبار، أو حساب تجريبي، أو خطة مجانية. فالسعر المرتفع ثاني أسباب رفض المطورين للأدوات، كما رأينا في أول مقال.
- الخطوات التالية في النهاية: روابط إلى أدلة المهام والمرجع. فمن نجح يريد أن يعرف ماذا بعد.
- صفحة تقرؤها الآلة أيضاً: ملف
llms.txt، ونشرحه بعد قليل.
هذه القواعد لا تتعلق بالكتابة الجميلة. كل قاعدة تمنع سبباً محدداً يجعل المطور يغلق الصفحة.
قالب صفحة البداية Template
هذا هيكل تبدأ منه، مع مثال لمنتج يرسل إشعارات. استبدل الأمثلة بمنتجك، واحذف ما لا ينطبق:
| الجزء | ماذا يحتوي | مثال |
|---|---|---|
| العنوان | نتيجة ووقت، لا «مقدمة إلى المنتج» | «أرسل أول إشعار خلال خمس دقائق» |
| سطر الهدف | ماذا سيبني القارئ | «سترسل إشعاراً تجريبياً، ثم من تطبيقك» |
| المتطلبات | حساب مجاني، والبرامج بأرقام إصداراتها | «حساب مجاني لا يحتاج بطاقة» |
| الخطوة 1 | إنشاء مفتاح الاختبار، بأسماء الأزرار كما في الشاشة تماماً | «من الإعدادات اضغط Create test key» |
| الخطوة 2 | أول طلب، مع النتيجة المتوقعة | نتيجة تقول إن الإشعار في وضع الاختبار |
| الخطوة 3 | نفس الشيء من تطبيق حقيقي، بنسخة محددة من المكتبة | «المكتبة بالنسخة 2.4.0» |
| ماذا بعد؟ | روابط إلى دليل مهمة ومرجع وشرح | «إرسال الإشعارات المجدولة» |
ولاحظ ثلاثة أشياء في القالب:
- نسخة المكتبة محددة: إذا تغير المنتج في نسخة لاحقة، لا تتعطل الصفحة على قارئ جديد قبل أن تحدثها.
- النتيجة تقول «وضع الاختبار»: حتى يعرف القارئ أنه لم يرسل شيئاً حقيقياً ولم يدفع.
- لا توجد خطوة ناقصة: إذا وجدت في صفحتك خطوة لا يمكن تنفيذها كما هي، فهي أول ما يحتاج إعادة كتابة.
كيف تتأكد أن الصفحة تعمل؟
الصفحة الصحيحة اليوم قد تصبح خاطئة غداً، عندما يتغير المنتج ولا تتغير الصفحة معه. لذلك تحتاج طريقتين للتأكد:
1. تجربة شخص جديد
ما هي: شخص لم ير الصفحة من قبل، يتبعها على جهاز جديد، وأنت تراقب أين يتوقف.
لماذا تهم: تلتقط ما لا تلتقطه أي آلة: زر تغير اسمه في الشاشة، أو صورة قديمة، أو جملة لم تعد صحيحة.
متى: مرة كل ربع سنة على الأقل، وبعد كل تغيير في شاشات المنتج.
2. اختبار آلي مع كل إصدار
ما هو: صفحة البداية فيها كل ما يحتاجه الاختبار: خطوات كاملة، وبعد كل خطوة النتيجة المتوقعة. فيستطيع فريق الهندسة أن يجعل جهازاً ينفذ الخطوات تلقائياً، ويقارن ما يحدث بالنتيجة المكتوبة.
لماذا يهم: إذا غير مهندس شيئاً في المنتج يعطل الصفحة، يفشل الاختبار قبل نشر الإصدار. فيعرف الفريق في نفس اليوم، بدل أن يكتشف المطورون ذلك واحداً بعد الآخر خلال أشهر.
انتبه: يجب أن يقارن الاختبار النتيجة نفسها، لا أن يكتفي بأن الخطوة «تمت». فبعض الأدوات تعتبر رسالة الخطأ نجاحاً، لأنها نجحت في الاتصال واستلام الرد. وقد رأينا هذا في تجربتنا: أداة curl، وهي أشهر أداة يستخدمها المطورون لإرسال طلب إلى منتج، استلمت رد الخطأ 401 (مفتاح غير صحيح)، ثم أعلنت أنها نجحت. فاختبار يكتفي بنجاح الخطوة كان سيمر والصفحة معطلة تماماً.
وفي التجربة نفسها درس ثان: عندما عدلنا الصفحة يدوياً للمفتاح الجديد، أدخلنا خطأ جديداً في خطوة أخرى، لأنها كانت مكتوبة على افتراض شكل المفتاح القديم. لم تكشفه القراءة بالعين، وكشفه الاختبار في أول تشغيل. والصفحة كلها، بثلاث خطوات، تختبر في أقل من ثانية، فلا يكلف الاختبار الفريق شيئاً يذكر.
والشكل التالي يبين أين يوضع هذا الاختبار في خط الإصدار:

ما تطلبه من فريق الهندسة:
- أن يعمل الاختبار على نسخة المنتج قبل النشر، فيختبر الصفحة والمنتج معاً.
- أن يستخدم مفتاح اختبار لحساب مخصص، محفوظاً في مكان سري لا يظهر في الملفات. فإذا تسرب، لا يرسل به أحد شيئاً حقيقياً.
- أن يفرق بين فشل الاتصال، فيعاد مرة واحدة، وفشل المقارنة، فلا يعاد. فالاختبار الذي يفشل أحياناً دون سبب يتعلم الفريق تجاهله.
كيف تقيس صفحة البداية؟
صفحة البداية قمع Funnel صغير، أي مراحل يمر بها الزائر ويخرج بعضهم في كل مرحلة. ويمكن أن تقيس كل خطوة فيها:
| المقياس | معناه | ماذا يخبرك |
|---|---|---|
| الوقت حتى أول نتيجة Time to First Call | من إنشاء الحساب حتى أول نتيجة ناجحة | أهم رقم في كل التوثيق |
| أين يتوقف القراء | تسجل حدثاً Event عند نسخ كل خطوة | الخطوة التي ينسخها كثيرون ولا ينسخون ما بعدها فيها المشكلة |
| البحث بلا نتائج | كلمات يبحث عنها القراء ولا يجدون لها صفحة | قائمة جاهزة بما يجب أن تكتبه |
| «هل كانت الصفحة مفيدة؟» | سؤال مع خانة نص | تعليق واحد مثل «الخطوة 3 لا تعمل» أنفع من ألف تقييم بالنجوم |
السؤال المفيد: ليس «ما متوسط الوقت؟»، وإنما «كم نسبة من أنشأ مفتاحاً ولم ينجح في أي طلب خلال ساعة؟». فمن لا ينجح خلال ساعة نادراً ما يعود، وآخر خطوة سجلها تقول أين توقف.
وقد شرحنا جمع هذه الأحداث دون إرسال بيانات القراء لطرف آخر في مقال مقاييس المنتج.
كيف تمنع الصفحة من أن تصبح قديمة؟ Docs as Code
المنتج يختبر مع كل تغيير، والتوثيق غالباً لا يختبر. لذلك تقدم صفحة Mixpost التي رأيناها.
والحل الذي تسميه مجموعة Write the Docs «التوثيق ككود» Docs as Code أن يعامل التوثيق بنفس طريقة المنتج. وعملياً يعني ذلك أربعة أشياء:
- نفس المكان: ملفات التوثيق مع ملفات المنتج، حتى يعدل المهندس الصفحة في نفس التعديل الذي غير فيه المنتج.
- نفس الاختبار: صفحة البداية تختبر آلياً مع كل إصدار، كما شرحنا.
- أرقام الإصدارات من مصدر واحد: حتى لا تحدث في مكان وتنسى في آخر.
- مراجعة دورية للنسخ الجاهزة: تنبيه عندما تمر سنة على نسخة مذكورة في الصفحة دون تحديث، كما في مثال Mixpost.
وانتبه للخطأ المعاكس أيضاً: صفحة تطلب «أحدث نسخة» latest دون رقم محدد. معناها أن القارئ اليوم يحصل على شيء مختلف عن قارئ الشهر الماضي، وقد تتعطل الصفحة يوماً دون أن يتغير فيها حرف.
والخطآن قد يكونان في صفحة واحدة. فحصنا في 27 أكتوبر 2026 كل النسخ الجاهزة Docker Images المذكورة في صفحة تثبيت Mixpost، وسألنا Docker Hub متى حدثت كل منها آخر مرة. ووجدنا أربع نسخ:
- قاعدة البيانات mysql/mysql-server:8.0: آخر تحديث لها 18 يناير 2023، أي قبل 1,378 يوماً. نسخة محددة، لكنها توقفت.
- الثلاث الأخرى (Mixpost نفسه وRedis وTraefik): بلا رقم نسخة، فهي «أحدث نسخة» دائماً. حدثت قبل أيام، لكنها قد تتغير في أي يوم دون علم أحد.

والحل لكليهما واحد: أرقام نسخ محددة في الصفحة، وفحص دوري ينبه عندما تمر سنة على نسخة دون تحديث، أو عندما تظهر «أحدث نسخة» في صفحة يفترض أنها درس.
المصدر: صفحة Docs as Code في Write the Docs.
التوثيق بالعربية، وللذكاء الاصطناعي
التوثيق بالعربية
إذا كان جمهورك عربياً، فالتوثيق العربي ميزة نادرة في أغلب المنتجات التقنية. وأدوات بناء مواقع التوثيق الحديثة تدعم العربية، مثل Docusaurus.
وثلاث قواعد عند الكتابة:
- الأوامر تبقى من اليسار إلى اليمين: حتى داخل صفحة عربية، وإلا ظهرت الرموز في أماكن خاطئة.
- رسائل الخطأ تبقى بالإنجليزية: كما يعرضها المنتج، لأن المطور سينسخها ويبحث بها. واشرح معناها بالعربية بجانبها.
- أسماء الأزرار تطابق الشاشة بحرفها: إذا كانت الشاشة بالإنجليزية، فالاسم في الصفحة بالإنجليزية، لأن المطور يبحث في الشاشة عن الكلمة التي قرأها.
واكتب المصطلح الإنجليزي بجانب العربي في أول ذكر، لأن المطور سيبحث بالإنجليزي عندما يواجه خطأ.
المصدر: صفحة الترجمة في Docusaurus.
ملف llms.txt للذكاء الاصطناعي
جزء متزايد من المطورين لا يقرأ صفحة البداية بنفسه، وإنما يطلب من مساعد البرمجة بالذكاء الاصطناعي أن يضيف المنتج إلى مشروعه.
ولهذا اقترح Jeremy Howard في سبتمبر 2024 ملف llms.txt. وهو ملف نصي في موقعك، فيه ملخص قصير وروابط إلى صفحات التوثيق بصيغة يسهل على الذكاء الاصطناعي قراءتها.
لماذا يهم: إذا وجد المساعد توثيقك بصيغة يقرؤها، كتب للمطور طريقة استخدام صحيحة. وإذا لم يجده، كتب طريقة قديمة أو مخترعة.
والشركات الثلاث في الجدول تنشره، وكذلك توثيق X. وعندما فتحنا ملفات الشركات الثلاث في 27 أكتوبر 2026، وجدنا لكل منها شكلاً مختلفاً:
- Stripe: ملف كبير، نحو 98 ألف بايت فيه 527 رابطاً، يبدأ بتعليمات موجهة للمساعد نفسه، منها أن يتحقق من أحدث نسخة للمكتبة بدل الاعتماد على ذاكرته.
- Supabase: ملف صغير، نحو 3 آلاف بايت و43 رابطاً، يحيل في أوله إلى ملف آخر فيه التوثيق كاملاً.
- Twilio: ملف كبير جداً، نحو 381 ألف بايت، فيه 1,767 رابطاً إلى نسخ نصية من صفحاته، مقسمة حسب المنتج.
ولاحظ تعليمات Stripe، لأنها نفس مشكلة هذا المقال من زاوية أخرى. المساعد الذي تعلم من توثيق قديم يكتب طريقة قديمة بثقة كاملة. والمطور قد يلاحظ تاريخ الصفحة، أما المساعد فلا.
llms.txt ثم تنساه. المساعد الذي يقرأ رابطاً قديماً فيه سيكتب للمطور طريقة لم تعد تعمل، والمطور لن يرى الملف ليكتشف المشكلة. اجعل فريق الهندسة يولده تلقائياً من نفس مصدر التوثيق مع كل نشر.المصدر: مقترح llms.txt، وملف توثيق X.
من يملك صفحة البداية؟
إذا كانت الإجابة «الجميع»، فهي عملياً لا أحد. المهندس يملك المنتج، ومدير المنتج يملك الشاشات، ومن كتب الصفحة قبل سنة لم يعد يفتحها.
لذلك اجعل للصفحة مالكاً واحداً بالاسم، غالباً من يعمل في علاقات المطورين DevRel. وله ثلاث مسؤوليات:
- يراجع كل تعديل يفشل فيه اختبار الصفحة.
- يجرب الصفحة بنفسه كل ربع سنة، وبعد كل تغيير في شاشات المنتج.
- يقرأ كل أسبوع أسئلة الدعم التي تذكر صفحة البداية.
والمسؤولية الأخيرة أهمها. فأسئلة الدعم غالباً أول إنذار. كل سؤال يعني شخصاً توقف وكان مهتماً بما يكفي ليسأل، وخلفه عدد لا تعرفه ممن توقفوا ولم يسألوا.
نصيحة عملية: أضف في نظام الدعم تصنيفاً لكل سؤال سببه التوثيق، واعرض عدده في التقرير الشهري الذي شرحناه في مقال علاقات المطورين DevRel. إذا ارتفع العدد، فهناك صفحة تحتاج إصلاحاً.
أخطاء شائعة
- صفحة بداية خلف تسجيل الدخول: لا يصل إليها محرك البحث ولا الذكاء الاصطناعي، ولا يستطيع المطور التقييم قبل أن يعطيك بريده.
- درس يبدأ بالنظرية: ثلاث فقرات عن تصميم المنتج قبل أول خطوة. مكانها صفحة الشرح.
- خطوات ناقصة: مثل «ثبت المتطلبات» دون أن تقول كيف.
- نسخ غير محددة: «أحدث نسخة» تعني أن الصفحة ستتعطل يوماً دون أن يتغير فيها حرف.
- لا أحد يملك الصفحة: إذا لم يكتب اسم شخص بجانبها، فلن يراجعها أحد.
- اختبار يكتفي بأن الخطوة «تمت»: قارن النتيجة نفسها، لأن رسالة الخطأ قد تحسب نجاحاً.
- أسئلة الدعم بلا تصنيف: السؤال المتكرر عن نفس الخطوة أول إنذار بأن الصفحة معطلة.
قائمة مراجعة Checklist قبل نشر صفحة البداية
| السؤال | إذا كانت الإجابة لا |
|---|---|
| هل في السطر الأول هدف ونتيجة ووقت؟ | اكتب «سترسل كذا خلال كذا» قبل أي شيء آخر |
| هل المتطلبات بأرقام إصدارات؟ | أضفها، فالمطور يكتشف عدم التوافق متأخراً ويلوم منتجك |
| هل كل خطوة كاملة ومعها النتيجة المتوقعة؟ | أكملها، فالنتيجة المتوقعة هي ما يجعل الصفحة قابلة للاختبار |
| هل يصل القارئ إلى أول نتيجة دون دفع؟ | وفر وضع اختبار أو حساباً تجريبياً |
| هل تختبر الصفحة آلياً مع كل إصدار؟ | اطلب ذلك من فريق الهندسة |
| هل كل النسخ في الصفحة محددة، ولا شيء منها قديم أكثر من سنة؟ | راجعها دورياً |
| هل جربها شخص جديد هذا الربع؟ | جربها، فأسماء الأزرار والصور لا يلتقطها اختبار |
| هل للصفحة مالك واحد بالاسم؟ | عين مالكاً |
الخلاصة
- صفحة البداية Quickstart هي صفحة الهبوط الحقيقية لمنتج المطورين، لأن التوثيق أول مصدر يتعلمون منه.
- هي درس Tutorial: هدف واحد ونجاح مضمون، والشرح والخيارات في صفحات أخرى.
- Stripe وTwilio وSupabase تتفق على هدف واضح، واختيار اللغة، وتجربة دون دفع، وسبب قصير في الخطوات الحساسة.
- أهم رقم: الوقت حتى أول نتيجة. وقس أين يتوقف القراء.
- اختبر الصفحة مع كل إصدار، وجربها بشخص جديد كل ربع سنة، وإلا ستصبح قديمة كما حدث في صفحة Mixpost.
- انشر ملف
llms.txtحتى يكتب الذكاء الاصطناعي طريقة صحيحة لمنتجك، وحدثه تلقائياً. - اجعل للصفحة مالكاً واحداً بالاسم، وتابع أسئلة الدعم التي تذكرها.
وفي المقال الأخير من السلسلة بإذن الله نتحدث عن المصادر المفتوحة كقناة نمو، وكيف يتحول المستخدم المجاني إلى عميل. والمقالات المرتبطة:
دليلالمصادر المفتوحة قناة للنمو: من المستخدم إلى العميلكيف يتحول مستخدمو مشروعك المفتوح إلى عملاء، ونماذج الربح الثلاثة، وأين تضع الخط بين المجاني والمدفوع، ودروس تغيير الرخص.
دليلعلاقات المطورين DevRel: ماذا يفعل الفريق وكيف يقاس؟ماذا يفعل فريق علاقات المطورين DevRel، وأين تضعه في شركتك، وكيف تقيس عمله، ومتى توظف أول شخص فيه.
دليلكيف تعمل محركات البحث؟ أساسيات SEO لصاحب الموقعماذا يحدث لصفحتك من النشر حتى الظهور في نتائج البحث، وأين تتوقف الصفحات عادة، وما الذي تطلبه من فريقك ليصلحه.
دليلالتسويق بالمحتوى Content Marketing: ماذا تكتب ولمن؟كيف تختار موضوعات تجيب عن أسئلة عملائك قبل أن يعرفوك، وترتبها في خطوات واضحة، وتقيس أثرها في البحث والمبيعات.سجل التحديثات
- 2026-11-13: إعادة كتابة المقال بلغة أوضح وخطوات وجداول، دون كود.
- 2026-11-14: مراجعة المقال وإعادة المعلومات المفيدة ونتائج البيانات الحقيقية التي حذفت في إعادة الكتابة.
- 27 أكتوبر 2026: إعادة كتابة المقال بقصة متصلة من مقال DevRel، وتجربة تشغيل صفحة البداية آلياً، وفحص صفحة تثبيت Mixpost، ومراجعة ملفات llms.txt لـ Stripe وSupabase وTwilio، وقسم ملكية الصفحة، وقائمة مراجعة.
- أكتوبر 2026: كتابة المقال، ومراجعة صفحات البداية في Stripe وTwilio وSupabase وصفحة تثبيت Mixpost في Docker وملفات llms.txt في 25 أكتوبر 2026.