Mintlify

Mintlify هي منصة توثيق للمطورين أسسها Han Wang و Hahnbee Lee، وهما من مؤسسي Y Combinator W22 السابقين، وقد صُممت لحل المشكلة الدائمة المتمثلة في تقادم الوثائق بمجرد إصدارها. وبدلاً من التعامل مع الوثائق كمهمة نشر ثابتة، تتعامل Mintlify معها كطبقة حية من منتجك، متصلة باستمرار بقاعدة التعليمات البرمجية الخاصة بك. اعتباراً من عام 2026، تخدم المنصة أكثر من 10,000 شركة بما في ذلك Anthropic و Cursor و Perplexity و Coinbase و Vercel و HubSpot و Zapier، وتصل إلى أكثر من 20 مليون مطور سنوياً وتتعامل مع أكثر من مليون استفسار توثيق مدعوم بالذكاء الاصطناعي كل شهر.

المنتج الأساسي عبارة عن خدمة توثيق مستضافة مبنية على MDX (Markdown مع مكونات React المضمنة) والنشر القائم على Git، مما يعني أن وثائقك تعيش جنباً إلى جنب مع التعليمات البرمجية الخاصة بك وتُنشر تلقائياً عند كل عملية إيداع (commit). تشمل القدرات الرئيسية Mintlify Agent (الذي تم إطلاقه في سبتمبر 2025)، والذي يراقب مستودعات GitHub الخاصة بك ويقترح تحديثات للوثائق كلما قمت بإصدار تغيير؛ ومساعد ذكاء اصطناعي مدمج داخل كل موقع توثيق منشور يقدم للمطورين إجابات حوارية؛ و API Playground يتم إنشاؤه تلقائياً ومبني على مواصفات OpenAPI 3.0+؛ ودعم مدمج لـ llms.txt و Model Context Protocol بحيث تظهر وثائقك داخل أدوات البرمجة بالذكاء الاصطناعي مثل Cursor و GitHub Copilot؛ وتحليلات تتتبع صحة الصفحات، واستعلامات البحث، وأنماط محادثات الذكاء الاصطناعي. المنصة حاصلة على شهادة SOC 2 Type II وجمعت 18 مليون دولار في جولة تمويل من الفئة A بقيادة Andreessen Horowitz في سبتمبر 2024.

ما الذي تقدمه Mintlify فعلياً في مايو 2026

تتمحور بنية Mintlify حول فلسفة "الوثائق كتعليمات برمجية" (docs-as-code). حيث تقوم بتأليف المحتوى في ملفات MDX، ودفعه (push) إلى مستودع GitHub أو GitLab متصل، وتقوم Mintlify ببناء واستضافة موقع التوثيق على بنيتها التحتية. وعلى عكس منصات إدارة المحتوى (CMS)، لا توجد قاعدة بيانات منفصلة للمحتوى بعيداً عن مستودع التعليمات البرمجية الخاص بك، مما يجعل إصدارات الوثائق متطابقة تماماً مع إصدارات التعليمات البرمجية.

يُعد Mintlify Agent، الذي تم إصداره في 29 سبتمبر 2025، أكبر ميزة تنافسية للمنصة مع دخول عام 2026. بمجرد تزويده بالسياق، أو طلب سحب (PR) على GitHub، أو سلسلة محادثات على Slack، أو رابط لسجل التغييرات، يقوم بصياغة صفحات توثيق جديدة، وتحديث المراجع الحالية، وإنشاء سجلات التغيير من مجموعات طلبات السحب، وتحويل محادثات الدعم إلى مقالات خدمة ذاتية. يفهم الوكيل بنية التنقل الخاصة بوثائقك، ومخطط Mintlify الخاص بك، والتعليمات البرمجية نفسها، لذلك يضع المحتوى الجديد بشكل صحيح بدلاً من إلقاء كل شيء في صفحة واحدة. تقوم الفرق بتهيئة الوكيل من خلال Slack أو مباشرة عبر واجهة برمجة التطبيقات (API)، مع وجود نقاط تكامل إضافية قيد التطوير.

يعمل مساعد الذكاء الاصطناعي المدمج في مواقع التوثيق المنشورة كطبقة حوارية فوق محتواك الحالي. يطرح المطورون أسئلة بلغة طبيعية؛ ويقوم المساعد باسترجاع المعلومات من وثائقك باستخدام تقنية RAG (استحوذت Mintlify على شركة البحث الناشئة Trieve في عام 2025 لتعزيز هذه الطبقة) ويولد إجابات دقيقة وموثوقة. بالنسبة لخصائص توثيق Anthropic، يصل هذا المساعد إلى 2 مليون مطور نشط شهرياً قبل أن يقوموا بتقديم تذكرة دعم.

تمت إعادة بناء API Playground بالكامل اعتباراً من عام 2025. يتم إنشاؤه تلقائياً من مواصفات OpenAPI 3.0+ الخاصة بك، ويدعم طرق المصادقة بما في ذلك مفاتيح API، و Bearer tokens، والمصادقة الأساسية (basic auth)، ويتيح للمطورين تجربة استدعاءات API حية مباشرة داخل وثائقك. عادةً ما تقوم الفرق التي تستخدم Firecrawl أو واجهات برمجة تطبيقات استخراج البيانات المشابهة بتوجيه المطورين إلى بيئة اللعب المستضافة على Mintlify كمرجع أساسي بدلاً من Postman أو مستكشفات API المستقلة.

شاركت Mintlify في ريادة معيار llms.txt لاكتشاف الوثائق القابلة للقراءة بواسطة الذكاء الاصطناعي في عام 2025. هذا يعني أن الوثائق المنشورة على Mintlify تظهر في سياقات أدوات النماذج اللغوية الكبيرة (LLM)، بما في ذلك عندما يستخدم المطورون v0، أو Codeium، أو مساعدي البرمجة بالذكاء الاصطناعي الآخرين الذين يحتاجون إلى الرجوع لوثائق المكتبة في وقت التوليد.

"لقد كان من المثير للإعجاب حقاً رؤية مدى سرعة تمكننا من إصدار وثائقنا باستخدام Mintlify." - Brian Krausz، من Anthropic، عبر مراجعة Ferndesk، 2026

موقع Mintlify مقارنة بـ GitBook و ReadMe

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

تستخدم GitBook محرراً يعتمد على الكتل (blocks) مشابهاً لـ Notion مع لوحة تحكم ويب في مركزه. وهو بالفعل أكثر سهولة في الاستخدام للمساهمين غير التقنيين الذين لا يستطيعون كتابة Markdown أو تشغيل سير عمل Git. ومع ذلك، يعاني محرك العرض الخاص بـ GitBook مع تعريفات OpenAPI المعقدة متعددة المواصفات، وتتطلب ميزات الذكاء الاصطناعي الخاصة به خططاً ذات فئة أعلى، وأصبح نموذج التسعير الخاص به مرهقاً للفرق متعددة اللغات: نظراً لأن النطاقات المخصصة والمواقع المترجمة تتطلب كل منها "خطط موقع" (Site Plans) مدفوعة منفصلة بسعر 65 دولاراً/شهرياً، فإن فريق التوثيق الذي يدير الوثائق بخمس لغات يدفع 325 دولاراً/شهرياً كرسوم للموقع قبل احتساب مقاعد المستخدمين. يُعد GitBook الخيار الأفضل لمواقع الويكي الداخلية وقواعد المعرفة حيث يساهم كل من التسويق والمنتج والهندسة. ولكنه أضعف عندما يكون المخرج الأساسي هو مرجع عام للمطورين يحتاج إلى البقاء متزامناً مع واجهة برمجة التطبيقات (API).

تُعد ReadMe.io المنصة الرائدة في مستكشف API التفاعلي. تقوم بيئة اللعب "Owlbert" الخاصة بها بإنشاء نماذج تعليمات برمجية بأكثر من 20 لغة، وتدعم بيئات الاختبار (staging)، وتوفر تحليلات API تُظهر بالضبط نقاط النهاية (endpoints) التي يصل إليها المطورون. بالنسبة لشركات منتجات API التي تعتبر وثائقها بحد ذاتها تجربة منتج لتأهيل المطورين، لا تزال الطبقة التفاعلية لـ ReadMe هي الأفضل في فئتها. يكمن القيد في احتكاك سير العمل: ReadMe هو نظام إدارة محتوى (CMS) مزود بلوحة تحكم ويب. المطورون الذين يفضلون الكتابة في محرر التعليمات البرمجية الخاص بهم، وإيداع (committing) ملفات markdown في Git، وتحديث الوثائق عند الدفع (push)، يجدون ReadMe غير مريح على الإطلاق. ميزاته المتقدمة بما في ذلك التحكم في الوصول القائم على الأدوار، و JavaScript المخصص، وسجلات النشاط مقفلة خلف خطة Enterprise بسعر 3,000+ دولار/شهرياً. تبدأ فئة Startup في ReadMe من 99 دولاراً/شهرياً، مما يجعلها أرخص من فئة Pro في Mintlify، ولكن مع أتمتة ذكاء اصطناعي أقل وبدون سير عمل "الوثائق كتعليمات برمجية".

المزايا الآلية لـ Mintlify على كليهما: التأليف الأصلي بـ MDX مع دعم كامل لمكونات React؛ واستخدام Git كمصدر وحيد للحقيقة (source-of-truth) لإدارة الإصدارات؛ و Mintlify Agent للتحديثات الآلية المستمرة (لا يقدم أي من المنافسين وكيل كتابة مستقل مشابه اعتباراً من عام 2026)؛ وتكامل llms.txt/MCP الذي يجعل الوثائق قابلة للقراءة بشكل أصلي بواسطة أدوات الذكاء الاصطناعي. عيوبها الآلية: ميزات تعاون مدمجة محدودة (لا توجد تعليقات مضمنة، ولا توجد قائمة انتظار لمراجعة الاقتراحات)، وتحليلات API تفاعلية أقل صقلاً من ReadMe، وفجوة تسعير تترك الفرق الصغيرة بدون خيار من الفئة المتوسطة.

"تتيح لنا Mintlify الحصول على وثائق جميلة وواضحة، تُدار بصيغة markdown." - Mark Phelps، مؤسس Flipt Cloud، على Product Hunt، 2024

كيف يبدو واقع سير عمل "الوثائق كتعليمات برمجية"

في اليوم الأول، تقوم بتهيئة مشروع Mintlify، وتوصيل مستودع GitHub الخاص بك، وتوجيه نطاق مخصص إلى شبكة توصيل المحتوى (CDN) الخاصة بـ Mintlify. يعيش المحتوى في ملفات MDX، ويتم الإعلان عن التنقل في ملف التكوين mint.json، وكل عملية دفع (push) إلى فرعك الرئيسي تؤدي إلى النشر في ثوانٍ. المهندسون الذين يقضون وقتهم بالفعل في VS Code يجدون هذا مريحاً على الفور؛ فلا يوجد تبديل للسياق إلى واجهة ويب منفصلة.

يتطلب إعداد API Playground ملف مواصفات OpenAPI، والذي تحتفظ به معظم فرق API بالفعل. قم بإسقاط مواصفات YAML أو JSON الخاصة بك في المستودع، وأشر إليها في mint.json، وستقوم Mintlify بإنشاء المرجع التفاعلي الكامل بما في ذلك منشئ الطلبات، وواجهة مستخدم المصادقة، وعلامات تبويب نماذج التعليمات البرمجية. عندما يتم تحديث المواصفات، يتم تحديث بيئة اللعب في عملية النشر التالية.

يتطلب دمج Mintlify Agent في سير عمل فريق حقيقي مزيداً من التخطيط. يتم تكوين الوكيل في Slack، لذلك يحتاج شخص ما إلى تعيين فروع مستودع GitHub التي تُشغل مساحات التوثيق المقابلة. بمجرد توصيله، يقترح الوكيل تحديثات الوثائق كطلبات سحب (pull requests) أو تعديلات مباشرة للمراجعة. تفيد الفرق بأن الوكيل يتعامل مع إنشاء سجلات التغيير وتحديثات المراجع بشكل جيد، ولكنه لا يزال يتطلب مراجعة بشرية للأدلة المفاهيمية والبرامج التعليمية حيث يهم الصوت السردي. يقوم الوكيل أيضاً بتحويل سلاسل تذاكر الدعم إلى مقالات خدمة ذاتية، وهو ما تجده الفرق التي تستخدم الدعم القائم على Slack قيماً للغاية.

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

لمن صُممت Mintlify

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

إنها تناسب بشكل خاص: الشركات الناشئة التي تركز على API والتي أُطلقت على Mintlify مبكراً (استخدمتها أكثر من 20% من أحدث دفعة في Y Combinator اعتباراً من عام 2024)؛ والشركات التي تعتبر فيها تجربة المطور وظيفة من وظائف نجاح العملاء؛ والفرق التي تجاوزت قدرات Confluence أو Notion لوثائق المطورين الموجهة للخارج؛ والمؤسسات التي تحتاج إلى ظهور وثائقها في أدوات البرمجة بالذكاء الاصطناعي لأن عملائها يستخدمون التطوير المدعوم بالنماذج اللغوية الكبيرة (LLM).

تُعد المنصة أيضاً قابلة للتطبيق بشكل متزايد للمؤسسات ذات متطلبات الامتثال المعقدة. إن شهادة SOC 2 Type II، والمراجعات الأمنية للمؤسسات المضمنة في خطة Enterprise، ونجاح العملاء المخصص تجعلها قوية في المراجعات الأمنية. تتواجد شركات Coinbase و PayPal و AT&T على المنصة اعتباراً من عام 2025.

ما لا تقدمه Mintlify

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

لا يمكن للمساهمين غير التقنيين الوصول إليها بدون تدريب. إذا كانت عملية التوثيق الخاصة بك تتضمن كتاب تسويق، أو مديري نجاح العملاء، أو مديري منتجات غير مرتاحين لاستخدام Git و Markdown، فإن Mintlify ستخلق احتكاكاً. تظل GitBook أو Notion خيارات أفضل للفرق المختلطة تقنياً.

إنها ليست الخيار الصحيح للفرق ذات التمويل الذاتي (bootstrap) أو في المراحل المبكرة التي تعمل بمعدل حرق أقل من 5 آلاف دولار/شهرياً حيث يمثل مبلغ 250-300 دولار/شهرياً للوثائق بنداً غير هين. تغطي Docusaurus (مفتوحة المصدر، ذاتية الاستضافة) أو فئة Hobby من Mintlify نفسها احتياجات الفرق التي لديها مساهم توثيق واحد حتى تدعم الإيرادات خطة Pro.

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