افتح هذه الأداة وابدأ التجربة الآن
https://www.mintlify.com/Mintlify منصة لنشر توثيق المنتجات والواجهات البرمجية، تعرّف نفسها اليوم بأنها «منصة توثيق للوكلاء»، أي أنها تكتب لقارئين معاً: المطوّر البشري، ونماذج الذكاء الاصطناعي التي صارت تقرأ التوثيق نيابةً عنه. ورأينا باختصار أنها من أفضل الخيارات للشركات الناشئة التي تريد توثيقاً أنيقاً دون أن تبني موقعاً من الصفر، فالخطة المجانية وحدها تكفي كثيراً من الفرق. غير أن القفزة إلى ميزات الذكاء الاصطناعي مكلفة، ولا تستحقها إلا فرق تعيش فعلاً على توثيقها.
ما الذي تحصل عليه مجاناً
تكتب الصفحات بصيغة Markdown أو MDX، وتستعمل مكوّنات جاهزة كالقوائم المطوية والتبويبات، ثم تزامنها مع مستودع Git أو تحررها من محرر في المتصفح يدقق الصيغة ويقترح الإكمال، وهناك أداة سطر أوامر لمعاينة الموقع محلياً. وتبني المنصة مرجع الـ API تلقائياً من ملف OpenAPI، مع ساحة تجربة يرسل منها القارئ طلبات حقيقية. وتشمل خطة Starter المجانية حتى خمسة محررين ونطاقاً خاصاً وبحثاً وخادم MCP لموقعك، فيستطيع مساعد البرمجة عندك أن يسأل توثيقك مباشرة، إضافةً إلى ملف llms.txt وتحسينات لمحركات البحث.
تعبت من التنقل بين عشرة تبويبات؟ ToolSuite يجمع أدوات الذكاء الاصطناعي التي يعتمد عليها المحترفون في مكان واحد.
جرّب ToolSuite الآنأين يبدأ الدفع، ولماذا
أما خطة Pro فبـ 450 دولاراً شهرياً عند الدفع السنوي، أو 540 دولاراً شهرياً، بحسب صفحة الأسعار. وهي تفتح المحررين بلا حد، والمساعد الذي يجيب القراء من التوثيق، ووكيلاً يكتب الصفحات ويحدّثها، و«أتمتة» تشغّل هذا الوكيل على جدول زمني أو عند كل دفعة إلى المستودع، فضلاً عن الترجمة الآلية والتحليلات. ويأتي مع الخطة عشرة آلاف رصيد شهرياً، ثم يُحتسب الرصيد بسنت واحد. وللتقدير: الإجابة الواحدة من المساعد تستهلك 25 رصيداً، والتحديث الآلي 250. وهناك تجربة مجانية لـ Pro مدتها 14 يوماً دون بطاقة، وخطة مؤسسات بسعر حسب الطلب فيها الدخول الموحد واستضافة في أوروبا أو على خوادمك.
ماذا تغيّر في الأسابيع الأخيرة
سجل التغييرات نشط على نحو لافت. ففي 25 سبتمبر صدر تطبيق سطح مكتب تجريبي لويندوز وماك ولينكس، وميزة «القراءة الصوتية» للصفحات، وإمكانية التراجع عن نشر سابق. وفي الثاني من أكتوبر صار الوكيل يقرأ تعليقات الفريق ويرد عليها. ثم جاء في 16 أكتوبر دعم OpenAPI 3.2 واللهجات الإقليمية للغات مثل en-GB وes-MX. وفي التحديث نفسه أُوقفت خدمة Mintlify Index، فمن كان يعتمد عليها فليراجع تكامله.
التوثيق بالعربية: مدعوم لغةً، غير مضمون اتجاهاً
تدرج صفحة الترجمة في توثيق Mintlify رمز ar ضمن اللغات المدعومة، إلى جانب العبرية، فيمكنك نشر نسخة عربية من توثيقك بجوار الإنجليزية. في المقابل، لم نجد في الصفحات التي قرأناها أي ذكر صريح لاتجاه الكتابة من اليمين إلى اليسار، ولا لطريقة إنتاج الترجمة الآلية أو مراجعتها. لذلك نقترح اختباراً بسيطاً قبل الالتزام: أنشئ صفحة تجريبية بالعربية تحتوي فقرة فيها أسماء دوال إنجليزية، وكتلة كود، وجدولاً، وقائمة مرقّمة، ثم انظر هل تنقلب الواجهة كلها، وهل تبقى الأقواس وعلامات الترقيم في مكانها الصحيح. فإن كان جمهورك من المطورين العرب، فهذا الاختبار أهم من أي ميزة ذكاء اصطناعي.
لمن تناسب
تناسب Mintlify الشركات التي تبيع واجهة برمجية أو منتجاً تقنياً، وتريد توثيقاً يقرؤه البشر ووكلاء البرمجة مثل Cursor وClaude Code على حد سواء. أما إن كان كل ما تحتاجه دليل استخدام بسيط، أو كانت ميزانيتك لا تحتمل 450 دولاراً شهرياً، فالخطة المجانية كافية، أو قد تكفيك أداة أخف.
هل أنت صاحب Mintlify؟ أضف شارة الدليل إلى موقعك
انسخ الشيفرة وضعها في تذييل موقعك أو صفحة «تحدّثوا عنّا». تشير الشارة إلى هذه الصفحة، فيصل زوّارك إلى وصف أداتك بالعربية والإنجليزية.
التعليقات
0لا توجد اي تعلقات بعد.
يرجى تسجيل الدخول للتعليق
التعليقات متاحة للأعضاء فقط. سجّل الدخول للمشاركة في النقاش، أو أنشئ حساباً جديداً مجاناً.