> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# التوثيق أداة تسويق: صفحة البداية Quickstart التي تقنع
- URL: https://arabroot.io/articles/التوثيق-اداة-تسويق-صفحة-البداية-quickstart/
- Published: 2026-10-25T05:25:00.000Z
- Updated: 2026-10-25T13:19:47.000Z
- Description: كيف تبني صفحة بداية Quickstart توصل المطور إلى أول نتيجة في دقائق، بما تفعله صفحات Stripe وTwilio وSupabase وقالب تبدأ منه.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, التسويق والمبيعات, الفرق والمنتج, DevRel

في أول مقال من هذه السلسلة رأينا أن التوثيق التقني هو أول مصدر يتعلم منه المطورون بنسبة 67.8% بحسب استبيان Stack Overflow لعام 2025، وهذا يعني أن صفحة في التوثيق هي غالباً أول ما يراه المطور من منتجك، قبل الصفحة الرئيسية وقبل صفحة الأسعار. وأهم صفحة في التوثيق كله هي صفحة البداية Quickstart، فهي المكان الذي يقرر فيه المطور خلال دقائق هل يكمل التجربة أم يغلق الصفحة ويجرب منافسك. ولنأخذ مثالاً حقيقياً صادفناه أثناء كتابة هذه السلسلة: صفحة تثبيت Mixpost في Docker في [توثيقه الرسمي](https://docs.mixpost.app/lite/installation/docker?ref=arabroot.io) تستخدم Docker Image لقاعدة البيانات اسمها `mysql/mysql-server:8.0`، و[صفحتها في Docker Hub](https://hub.docker.com/r/mysql/mysql-server?ref=arabroot.io) تبين أن آخر تحديث لها كان في 18 يناير 2023، أي أن كل من ينسخ الملف كما هو يشغل قاعدة بيانات لم تصلها تحديثات منذ قرابة ثلاث سنوات. والمشروع نفسه نشط وجيد، ولكن الصفحة التي يقرأها كل مستخدم جديد لم تراجع.

المواضيع في سلسلة التسويق للمطورين DevRel:

- التسويق للمطورين Developer Marketing: لماذا يتجاهلون الإعلانات؟
- علاقات المطورين DevRel: ماذا يفعل الفريق وكيف يقاس؟
- التوثيق أداة تسويق: صفحة البداية Quickstart التي تقنع (الموضوع الحالي)
- المصادر المفتوحة قناة للنمو: من المستخدم إلى العميل

[![](https://arabroot.io/content/images/2026/10/developer-marketing-cover-cover.webp)دليلالتسويق للمطورين Developer Marketing: لماذا يتجاهلون الإعلانات؟لماذا لا يقتنع المطور بالإعلان، وما الذي يجعله يجرب أداة ويوصي بشرائها، بأرقام استبيان Stack Overflow 2025 وأمثلة حقيقية.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B3%D9%88%D9%8A%D9%82-%D9%84%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86-developer-marketing/)[![](https://arabroot.io/content/images/2026/10/devrel-cover-cover.webp)دليلعلاقات المطورين DevRel: ماذا يفعل الفريق وكيف يقاس؟ما الذي يفعله فريق علاقات المطورين في التوثيق والمحتوى والمجتمع، وأين يوضع في الشركة، وكيف يقاس عمله بأمثلة GitLab وHacktoberfest.](https://arabroot.io/articles/%D8%B9%D9%84%D8%A7%D9%82%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86-devrel/)

وفي هذا المقال سوف نتناول:

- أنواع التوثيق الأربعة، وأين تقع صفحة البداية بينها.
- ماذا تفعل صفحات البداية في Stripe وTwilio وSupabase، وما المشترك بينها.
- قواعد صفحة البداية التي تقنع، مع السبب لكل قاعدة.
- قالب جاهز تبدأ منه صفحة البداية لمنتجك.
- كيف تقيس الصفحة، وكيف تمنعها من أن تتقادم.
- التوثيق بالعربية، والتوثيق الذي يقرؤه وكيل الذكاء الاصطناعي AI Agent.

## أنواع التوثيق الأربعة

أكثر خطأ نراه في التوثيق هو خلط الأنواع، فتجد صفحة بداية فيها شرح نظري طويل، أو مرجعاً للـ API فيه قصة، والنتيجة أن القارئ لا يجد ما جاء من أجله. ويقسم إطار [Diátaxis](https://diataxis.fr/?ref=arabroot.io) التوثيق إلى أربعة أنواع لأربع حاجات مختلفة، والشكل التالي يرتبها:

![مربع من أربعة أنواع للتوثيق بحسب إطار Diátaxis: الدروس Tutorials للتعلم بالتطبيق وفيها صفحة البداية Quickstart، وأدلة المهام How-to guides لتنفيذ مهمة محددة، والمرجع Reference لمعلومة دقيقة أثناء العمل، والشرح Explanation لفهم السبب والتصميم](https://arabroot.io/content/images/2026/10/docs-as-marketing-01-four-kinds.webp)

صفحة البداية درس Tutorial: هدفها أن ينجح القارئ، وليس أن يعرف كل شيء

- **الدرس Tutorial**: يأخذ القارئ الجديد بيده خطوة بخطوة حتى ينجح في شيء صغير. وصفحة البداية من هذا النوع، فالمهم أن يصل إلى النتيجة، وليس أن يفهم كل الخيارات.
- **دليل المهمة How-to Guide**: لمن يعرف المنتج ويريد تنفيذ مهمة محددة، مثل «كيف أسترد مبلغاً» أو «كيف أضيف نطاقاً».
- **المرجع Reference**: وصف دقيق لكل نقطة في الـ API وكل خيار، يرجع إليه المطور أثناء العمل.
- **الشرح Explanation**: لماذا صمم المنتج بهذه الطريقة، والمفاهيم التي يقوم عليها.

والقاعدة العملية هنا: لا تقم بإدخال الشرح أو الخيارات الإضافية في صفحة البداية، والسبب أن كل فقرة لا يحتاجها القارئ لينجح الآن هي فرصة ليتوقف، وضع بدلاً منها رابطاً في آخر الصفحة إلى الشرح أو المرجع.

## ماذا تفعل صفحات البداية المعروفة؟

فتحنا ثلاث صفحات بداية لمنتجات يعرفها أغلب المطورين في 25 أكتوبر 2026، ودوننا ما تفعله كل منها:

| ما في الصفحة                | [Stripe Payments](https://docs.stripe.com/payments/quickstart?ref=arabroot.io)                  | [Twilio SMS](https://www.twilio.com/docs/messaging/quickstart?ref=arabroot.io)             | [Supabase Next.js](https://supabase.com/docs/guides/getting-started/quickstarts/nextjs?ref=arabroot.io) |
| --------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| الهدف                       | صفحة دفع تعمل على موقعك                                                                         | إرسال رسالة SMS واستقبالها والرد عليها                                                     | تطبيق Next.js يقرأ من جدول في قاعدة البيانات                                                            |
| اختيار اللغة أو الإطار      | نعم، والكود يتغير معه                                                                           | نعم، ثماني لغات منها Python وNode.js وPHP وJava وGo                                        | صفحة مستقلة لكل إطار                                                                                    |
| الخطوات                     | جزءان: السيرفر ثم المتصفح، وفي كل منهما خطوات صغيرة                                             | المتطلبات، ثم التسجيل وحساب تجريبي Trial، ثم الإرسال، ثم الاستقبال والرد                   | ثماني خطوات مرقمة، واحدة منها اختيارية                                                                  |
| شرح السبب في الخطوات المهمة | نعم، مثل إنشاء جلسة الدفع على السيرفر لأنها تحتاج المفتاح السري الذي لا يجوز أن يظهر في المتصفح | نعم، مثل أن المفتاح السري يظهر مرة واحدة فقط فاحفظه                                        | نعم، مثل تفعيل Row Level Security على الجدول قبل فتح القراءة                                            |
| تجربة دون دفع               | [مفاتيح بيئة الاختبار Sandbox](https://docs.stripe.com/keys?ref=arabroot.io)                    | حساب تجريبي ورقم افتراضي Virtual Phone                                                     | مشروع على [الخطة المجانية](https://supabase.com/pricing?ref=arabroot.io)                                |
| اختصار للخطوات              | تنزيل المشروع كاملاً Download example                                                           | زر لنسخ الصفحة بصيغة Markdown                                                              | زر يملأ أوامر SQL في المحرر مباشرة، وأمر npx create-next-app -e with-supabase                           |
| للذكاء الاصطناعي            | زر Ask AI، وملف llms.txt                                                                        | قسم Build with AI، والنسخ بصيغة Markdown «مفيد للمشاركة أو للنماذج اللغوية»، وملف llms.txt | نص جاهز تعطيه لمساعد البرمجة، وخطوة اختيارية لإعداد MCP، وملف llms.txt                                  |

ولاحظ أن الصفحات الثلاث تتفق في أشياء لا علاقة لها بالتصميم: هدف واحد واضح من أول سطر، واختيار لغة القارئ بدل إجباره على لغة واحدة، وطريقة للتجربة دون بطاقة ائتمان، وشرح قصير للسبب عند كل خطوة قد يتجاوزها القارئ فيقع في مشكلة أمنية. وفي 2026 أضافت الثلاث شيئاً جديداً: طريقة ليقرأ وكيل الذكاء الاصطناعي الصفحة، لأن جزءاً متزايداً من المطورين لا يقرأ صفحة البداية بنفسه وإنما يعطيها لمساعد البرمجة.

## قواعد صفحة البداية التي تقنع

الشكل التالي يبين أجزاء صفحة البداية بالترتيب الذي يقرؤه المطور:

![رسم لصفحة بداية من الأعلى إلى الأسفل: سطر الهدف وما سوف تبنيه، ثم المتطلبات بالإصدارات، ثم اختيار اللغة، ثم خطوات مرقمة لكل خطوة أمر كامل ونتيجة متوقعة، ثم أول نتيجة حقيقية مثل رسالة أو صفحة دفع، ثم الخطوات التالية بروابط لأدلة المهام والمرجع. وعلى الجانب ثلاث إضافات: وضع اختبار دون بطاقة، ومشروع جاهز للتنزيل، وملف llms.txt](https://arabroot.io/content/images/2026/10/docs-as-marketing-02-quickstart-anatomy.webp)

أجزاء صفحة البداية، وكل جزء يجيب عن سؤال يطرحه المطور في تلك اللحظة

1. **هدف واحد في أول سطر**: «سوف ترسل أول رسالة SMS من تطبيق Python». والسبب أن المطور يقرر من السطر الأول هل هذه الصفحة لمشكلته.
2. **المتطلبات بالإصدارات**: «Python من 3.8 إلى 3.13» كما تفعل Twilio، وليس «Python مثبت». فالمطور الذي يكتشف في الخطوة الخامسة أن إصداره لا يعمل سوف يلوم منتجك وليس جهازه.
3. **أوامر كاملة تنسخ وتعمل**: لا تقم بكتابة «عدل الملف بحسب بيئتك»، والسبب أن هذه الجملة تعني أن الصفحة لم تعد درساً، والقيمة الوحيدة التي يغيرها القارئ هي المفتاح، وضعها في متغير بيئة Environment Variable باسم واضح.
4. **النتيجة المتوقعة بعد كل خطوة**: المخرج الذي سوف يراه، حتى يعرف أنه على الطريق الصحيح قبل أن يكمل.
5. **سبب قصير في الخطوة الحساسة**: مثل جملة Stripe عن المفتاح السري، والسبب أن الدرس الذي يعلم المطور طريقة خاطئة أمنياً ينتقل إلى الإنتاج كما هو.
6. **تجربة دون دفع**: وضع اختبار، أو حساب تجريبي، أو خطة مجانية، فالسعر المرتفع ثاني أسباب رفض الأدوات عند المطورين كما رأينا في أول مقال، والمطالبة بالبطاقة قبل أول نتيجة تشبهه في نظره.
7. **الخطوات التالية في النهاية**: روابط إلى أدلة المهام والمرجع، فالمطور الذي نجح يريد أن يعرف ماذا يفعل بعد ذلك.
8. **صفحة تقرؤها الآلة أيضاً**: ملف `llms.txt` وزر للنسخ بصيغة Markdown، وسوف نشرحهما بعد قليل.

## قالب تبدأ منه

القالب التالي بصيغة Markdown لصفحة بداية لمنتج افتراضي فيه API لإرسال الإشعارات، استبدل الأسماء بمنتجك واحذف ما لا ينطبق، ولاحظ أن كل خطوة فيها أمر كامل ونتيجة متوقعة:

```markdown
# أرسل أول إشعار خلال خمس دقائق

سوف ترسل إشعاراً تجريبياً من سطر الأوامر، ثم من تطبيق Python.

## المتطلبات

- حساب مجاني في https://app.example.com (لا يحتاج بطاقة)
- Python من 3.10 إلى 3.13
- curl

## 1. أنشئ مفتاح وضع الاختبار

من لوحة التحكم افتح Settings ثم API Keys واضغط Create test key.
المفتاح يبدأ بـ test_ ويظهر مرة واحدة فقط، فاحفظه في متغير بيئة:

    export EXAMPLE_API_KEY="test_xxxxxxxx"

## 2. أرسل أول إشعار

    curl -s https://api.example.com/v1/notifications \
      -H "Authorization: Bearer $EXAMPLE_API_KEY" \
      -d to=dev@example.com -d text="مرحباً"

النتيجة المتوقعة:

    {"id":"ntf_123","status":"queued","mode":"test"}

## 3. من تطبيق Python

    pip install example-sdk==2.4.0

...

## ماذا بعد؟

- إرسال الإشعارات المجدولة (دليل مهمة)
- مرجع الـ API الكامل
- لماذا نستخدم الطوابير في الإرسال (شرح)
```

في القالب أعلاه لاحظ التالي:

- العنوان يعد بنتيجة ووقت، وليس «مقدمة إلى المنتج».
- المفتاح في متغير بيئة بدل أن يلصق في الأمر، حتى لا يبقى في سجل الأوامر History ولا في لقطات الشاشة.
- رقم إصدار المكتبة مثبت `2.4.0`، فإذا تغيرت الـ API في إصدار لاحق لن تتعطل الصفحة على قارئ جديد قبل أن تحدثها.
- النتيجة المتوقعة فيها `"mode":"test"`، حتى يعرف القارئ أنه لم يرسل شيئاً حقيقياً ولم يدفع.

## كيف تقيس صفحة البداية؟

صفحة البداية قمع صغير، وكل خطوة فيها يمكن أن تقيسها:

- **الوقت حتى أول نتيجة Time to First Call**: بين إنشاء الحساب وأول طلب ناجح إلى الـ API. وهذا أهم رقم في كل التوثيق.
- **أين يتوقف القراء**: إذا سجلت حدثاً Event عند نسخ الكود في كل خطوة، فسوف ترى الخطوة التي ينسخها كثيرون ولا ينسخون ما بعدها، وهذه الخطوة فيها المشكلة.
- **البحث بلا نتائج**: كلمات يبحث عنها القراء في التوثيق ولا يجدون لها صفحة، فهي قائمة جاهزة لما يجب أن تكتبه.
- **سؤال «هل كانت هذه الصفحة مفيدة؟»**: مع خانة نص، فالتعليق الواحد الذي يقول «الخطوة 3 لا تعمل على Windows» أنفع من ألف تقييم بالنجوم.

وقد شرحنا جمع هذه الأحداث دون أن ترسل بيانات القراء لطرف آخر في [مقال مقاييس المنتج](https://arabroot.io/articles/%D9%85%D9%82%D8%A7%D9%8A%D9%8A%D8%B3-%D8%A7%D9%84%D9%85%D9%86%D8%AA%D8%AC-%D9%88%D8%AA%D8%AD%D9%84%D9%8A%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-product-metrics/).

## كيف تمنع الصفحة من أن تتقادم؟

رأينا في أول المقال كيف بقيت Docker Image قديمة في صفحة تثبيت مشروع نشط، وهذا يحدث في كل مشروع تقريباً، لأن الكود يختبر مع كل تغيير والتوثيق لا يختبر. والحل الذي تسميه مجموعة Write the Docs [التوثيق ككود Docs as Code](https://www.writethedocs.org/guide/docs-as-code/?ref=arabroot.io) هو أن تكتب التوثيق بنفس أدوات الكود: Git ومراجعة الكود Code Review والاختبارات الآلية. وعملياً يعني ذلك:

- ضع ملفات التوثيق في نفس المستودع مع الكود، حتى يعدل المطور الصفحة في نفس طلب الدمج الذي غير فيه السلوك.
- استخرج أوامر صفحة البداية إلى سكربت، وشغله في خط CI/CD في Container نظيف مع كل إصدار، فإذا فشل السكربت فشل الإصدار.
- اجعل أرقام الإصدارات في الصفحة متغيرات تأتي من نفس ملف الإصدار، حتى لا تحدث في مكان وتنسى في آخر.
- راجع الصفحة يدوياً على جهاز جديد مرة كل ربع سنة على الأقل، فبعض المشكلات لا يكتشفها السكربت، مثل زر تغير اسمه في لوحة التحكم.

## التوثيق بالعربية، وللآلة

إذا كان جمهورك عربياً فالتوثيق العربي ميزة نادرة في أغلب المنتجات التقنية، وأدوات بناء مواقع التوثيق الحديثة تدعم ذلك، فمثلاً تذكر [صفحة الترجمة في Docusaurus](https://docusaurus.io/docs/i18n/introduction?ref=arabroot.io) أن اللغات التي تكتب من اليمين إلى اليسار مثل العربية مدعومة. وعند الكتابة احتفظ بالكود والأوامر وأسماء الحقول بالإنجليزية ومن اليسار إلى اليمين، واكتب المصطلح الإنجليزي بجانب العربي في أول ذكر، لأن المطور سوف يبحث بالمصطلح الإنجليزي عندما يواجه خطأ.

وأما الآلة، فقد اقترح Jeremy Howard في سبتمبر 2024 [ملف llms.txt](https://llmstxt.org/?ref=arabroot.io)، وهو ملف Markdown في جذر الموقع أو تحت مسار التوثيق، فيه عنوان وملخص قصير ثم قوائم روابط إلى صفحات مكتوبة بصيغة يسهل على النموذج اللغوي قراءتها. والمنتجات الثلاثة في الجدول أعلاه تنشره، وكذلك [توثيق X API](https://docs.x.com/llms.txt?ref=arabroot.io). والفكرة بسيطة: المطور الذي يطلب من مساعد البرمجة «أضف الدفع إلى مشروعي» سوف يحصل على كود صحيح إذا وجد المساعد توثيقك بصيغة يقرؤها، وعلى كود قديم أو مخترع إذا لم يجده.

⚠️

لا تقم بنشر `llms.txt` ثم تنساه، والسبب أن الوكيل الذي يقرأ رابطاً قديماً فيه سوف يكتب للمطور كوداً لإصدار لم يعد يعمل، والمطور لن يرى الملف ليكتشف المشكلة. ولد الملف آلياً من نفس مصدر التوثيق مع كل نشر.

## أخطاء شائعة

- **صفحة بداية خلف تسجيل الدخول**: لا يصل إليها محرك البحث ولا وكيل الذكاء الاصطناعي، ولا يستطيع المطور التقييم قبل أن يعطيك بريده.
- **درس يبدأ بالنظرية**: ثلاث فقرات عن بنية المنتج قبل أول أمر، والمكان الصحيح لها صفحة الشرح.
- **أوامر ناقصة**: `...` في وسط ملف إعداد، أو خطوة «ثبت المتطلبات» دون الأمر.
- **إصدارات غير مثبتة**: `latest` في صفحة البداية يعني أن الصفحة سوف تتعطل يوماً دون أن يتغير فيها حرف.
- **لا أحد يملك الصفحة**: إذا لم يكن اسم شخص أو فريق مكتوباً بجانب صفحة البداية فلن يراجعها أحد.

## الخلاصة

- صفحة البداية Quickstart هي صفحة الهبوط الحقيقية لمنتج يستخدمه المطورون، لأن التوثيق أول مصدر يتعلمون منه.
- هي درس Tutorial بحسب Diátaxis: هدف واحد ونجاح مضمون، والشرح والخيارات في صفحات أخرى.
- Stripe وTwilio وSupabase تتفق على هدف واضح، واختيار اللغة، وتجربة دون دفع، وسبب قصير في الخطوات الحساسة، وصيغة يقرؤها الذكاء الاصطناعي.
- قس الوقت حتى أول نتيجة والخطوة التي يتوقف عندها القراء.
- اختبر صفحة البداية مع كل إصدار كما تختبر الكود، وإلا فسوف تتقادم كما تقادمت صفحة تثبيت Mixpost.

وفي المقال الأخير من السلسلة بإذن الله سوف نتحدث عن المصادر المفتوحة كقناة نمو، وكيف يتحول المستخدم المجاني إلى عميل. والمقالات المرتبطة:

[![](https://arabroot.io/content/images/2026/10/oss-growth-cover-cover.webp)دليلالمصادر المفتوحة قناة للنمو: من المستخدم إلى العميلكيف تحول الشركات مستخدمي مشروعها المفتوح إلى عملاء، ونماذج الربح من الخدمة المستضافة إلى Open Core، ودروس تغيير الرخص بعد النمو.](https://arabroot.io/articles/%D8%A7%D9%84%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D9%82%D9%86%D8%A7%D8%A9-%D9%84%D9%84%D9%86%D9%85%D9%88/)[![](https://arabroot.io/content/images/2026/10/devrel-cover-cover.webp)دليلعلاقات المطورين DevRel: ماذا يفعل الفريق وكيف يقاس؟ما الذي يفعله فريق علاقات المطورين في التوثيق والمحتوى والمجتمع، وأين يوضع في الشركة، وكيف يقاس عمله بأمثلة GitLab وHacktoberfest.](https://arabroot.io/articles/%D8%B9%D9%84%D8%A7%D9%82%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86-devrel/)[![](https://arabroot.io/content/images/2026/10/seo-basics-cover-cover.webp)دليلكيف تعمل محركات البحث؟ SEO من الداخل للمطورينماذا يحدث لصفحتك من الزحف إلى الفهرسة إلى الترتيب، وأين تتوقف عادة، وما الذي يملكه المطور لإصلاحه.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D9%85%D8%AD%D8%B1%D9%83%D8%A7%D8%AA-%D8%A7%D9%84%D8%A8%D8%AD%D8%AB-seo-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84/)

## سجل التحديثات

- أكتوبر 2026: كتابة المقال، ومراجعة صفحات البداية في Stripe وTwilio وSupabase وصفحة تثبيت Mixpost في Docker وملفات `llms.txt` في 25 أكتوبر 2026.