---
title: 'توثيقٌ يواكب الكود'
description: 'LaRecipe موقع توثيق يعيش داخل تطبيق Laravel الخاص بك، يكتبه ويحدّثه وكيل البرمجة الذي تستخدمه أصلًا. وله هدف واحد: ألّا يتأخر توثيقك عن كودك أبدًا، فيقرأ الناس والوكلاء دائمًا الإجابة الحالية.'
url: 'https://larecipe.saleem.dev/ar/3.x'
version: 3.x
locale: ar
last_updated: '2026-10-19'
---

> Docs index: https://larecipe.saleem.dev/3.x/llms.txt · MCP: https://larecipe.saleem.dev/mcp · Skill: https://larecipe.saleem.dev/skill.md

# توثيقٌ يواكب الكود

تكتب الصفحات بصيغة Markdown في مستودعك، بجوار الكود الذي تشرحه. يقرؤها الناس موقعًا سريعًا، ويقرأ الوكلاء الصفحات نفسها بصيغة Markdown، وعبر `llms.txt` وخادم MCP.

![موقع توثيق LaRecipe في المتصفح: الشريط الجانبي، وصفحة المقدمة هذه، ولوحة الإجراءات للوكلاء مثل نسخ كـ Markdown وربط MCP. وعلى النافذة شارة: أكثر من 3 ملايين تنزيل.](https://larecipe.saleem.dev/_assets/3.x/introduction.webp)

تذكر كل صفحة الكود الذي تشرحه. وحين يتغيّر ذلك الكود، يحدّث وكيل البرمجة الذي أجرى التغيير الصفحةَ قبل أن يرفع عمله، وإن نسي يوقف خطّافٌ عملية الـ push مرة واحدة. فيصل التوثيق في الـ pull request نفسه مع الكود، وتراجع الاثنين معًا.

يتغيّر كودك، فيجد LaRecipe صفحات التوثيق التي تذكر ذلك الكود مصدرًا لها. ويحدّثها وكيل البرمجة قبل أن يرفع عمله، فيصل الكود والتوثيق في الـ pull request نفسه ويُدمجان معًا. ثم يقرأ الناس موقع التوثيق، ويقرأ الوكلاء الصفحات نفسها بصيغة Markdown، وعبر llms.txt وخادم MCP.

كيف يُبقي LaRecipe التوثيق محدّثًا:

1. يتغيّر كودك في commit.
2. يجد LaRecipe صفحات التوثيق التي تذكر ذلك الكود مصدرًا لها، ويحدّثها وكيل البرمجة قبل أن يرفع عمله.
3. يصل الكود والتوثيق في الـ pull request نفسه، فتراجعهما معًا ويُدمجان معًا.
4. ثم يقرأ الناس موقع التوثيق، ويقرأ الوكلاء الصفحات نفسها بصيغة Markdown، وعبر `llms.txt` وخادم MCP.

يتتبّع المخطط مثالًا واحدًا. «يتغيّر كودك»: الـ commit ‏`a1f3c9e` (`feat: refund invoices`)، فتصبح `refunds.md` «قديمة» لأنه «تغيّر مصدرها». ثم «وكيلك يحدّث التوثيق»: صفحة `docs/billing/refunds.md` بعنوان «الاسترداد» (تبويبا «الدليل» و API) تقول: «استرد مبلغ فاتورة مدفوعة كاملًا أو جزءًا منه، من التطبيق أو بأمر واحد.» مع `php artisan invoices:refund 1042`، وعليها «حُدّث قبل دقيقتين» و«حدّثه Claude Code» في PR #412. ويضمّ الـ pull request ‏#412 «Add invoice refunds» الاثنين معًا، «كود» + «توثيق»، وقد «دُمج» بهما معًا. ثم «يقرأ الوكلاء» الصفحة وهم «متصلون عبر MCP» أو عبر `llms.txt`، و«يقرأ الناس» الموقع، حيث يكتبون «اسأل الذكاء الاصطناعي» أو «اسأل التوثيق».

لـ LaRecipe أكثر من 3 ملايين تنزيل، وذُكر في [Laravel News](https://laravel-news.com/larecipe-documentation-package) و [DevDojo](https://devdojo.com/episode/larecipe) و Medium و [Packalyst](https://packagist.org/packages/binarytorch/larecipe) و [Product Hunt](https://www.producthunt.com/posts/larecipe-beautiful-docs).

## التثبيت بأمرين

الصق هذا الطلب في Claude Code أو Codex أو Cursor أو أي وكيل برمجة، داخل تطبيق Laravel الخاص بك.

```text
ثبّت LaRecipe في تطبيق Laravel هذا:

1. شغّل `composer require larecipe/larecipe`.
2. شغّل `php artisan larecipe:install --no-interaction` لتبقى القيم الافتراضية.
3. شغّل `php artisan larecipe:doctor` وأصلح كل ما يذكره.
4. اقرأ التطبيق واكتب توثيقًا أوليًا بمهارة larecipe-write-docs.

ثم أخبرني برابط موقع التوثيق.
```

يدويًا: شغّل هذا في تطبيق Laravel الخاص بك. الصقه في الطرفية، اضغط Enter للقيم الافتراضية، ثم افتح `/docs`:

```bash
composer require larecipe/larecipe
php artisan larecipe:install
```

لا حاجة إلى Node ولا إلى خطوة بناء. ويُعِدّ المثبّت أيضًا وكلاء البرمجة الذين تستخدمهم أصلًا، مثل Claude Code و Codex و Cursor، فلا شيء عليك أن تتذكره في عملك اليومي.

## ما تحصل عليه

- [توثيق يبقى محدّثًا](https://larecipe.saleem.dev/ar/3.x/keeping-current/how-it-works.md): يحدّث وكيل البرمجة الصفحات التي يمسّها التغيير، في الـ pull request نفسه.
- [مصمَّم للوكلاء](https://larecipe.saleem.dev/ar/3.x/agents/surfaces.md): كل صفحة بصيغة Markdown، مع llms.txt وخادم MCP.
- [اسأل الذكاء الاصطناعي](https://larecipe.saleem.dev/ar/3.x/agents/ask-ai.md): إجابات مكتوبة من توثيقك وحده، مع الصفحات التي تستشهد بها.
- [المراجع الحية](https://larecipe.saleem.dev/ar/3.x/writing/live-references.md): المسارات والأوامر والنماذج والأحداث، تُقرأ من تطبيقك العامل.
- [توثيق خاص](https://larecipe.saleem.dev/ar/3.x/writing/gate-blocks.md): تحدّد المصادقة والبوابات في تطبيقك من يقرأ، حتى الفقرة الواحدة.
- [بكل لغة](https://larecipe.saleem.dev/ar/3.x/writing/languages.md): مع الكتابة من اليمين إلى اليسار، وعرض الأصل للصفحات التي لم تُترجم بعد.

## الخطوة التالية

- [التثبيت](https://larecipe.saleem.dev/ar/3.x/get-started/installation.md): المتطلبات، وأسئلة المثبّت، والملفات التي يكتبها.
- [توثيقك الأول](https://larecipe.saleem.dev/ar/3.x/get-started/your-first-docs.md): دع وكيل البرمجة يقرأ تطبيقك ويكتب صفحات أولية.
- [اكتب صفحة](https://larecipe.saleem.dev/ar/3.x/writing/markdown.md): Markdown والمكوّنات وأمثلة الكود المأخوذة من تطبيقك.
- [كيف يعمل](https://larecipe.saleem.dev/ar/3.x/keeping-current/how-it-works.md): كيف يجد LaRecipe الصفحات التي جعلها تغييرٌ ما قديمة.

تنقل موقعًا من LaRecipe 2؟ اقرأ [الترقية من الإصدار 2](https://larecipe.saleem.dev/ar/3.x/upgrade.md).

## ابقَ على اطلاع

ملاحظات إصدارات LaRecipe عبر البريد الإلكتروني. يمكنك إلغاء الاشتراك في أي وقت. اشترك عبر عنوان بريدك الإلكتروني: https://larecipe.saleem.dev/newsletter

هذا النموذج مكوّن React مخصّص يضيفه هذا الموقع إلى LaRecipe. شاهد كيف بُني: https://larecipe.saleem.dev/ar/3.x/customize/custom-components