ينتقل مشروع Docsy مفتوح المصدر، الذي أنشأته Google لبناء مواقع التوثيق باستخدام مولد المواقع الثابتة Hugo، إلى Linux Foundation في وقت أصبحت فيه الوثائق التقنية مصدراً مباشراً لوكلاء الذكاء الاصطناعي، وليس للمطورين وحدهم.
أعلنت Erin McKean، مهندسة علاقات المطورين في Google وعضو اللجنة التوجيهية لـDocsy، الخطوة خلال كلمة ألقتها الأربعاء في قمة Linux Foundation للمصادر المفتوحة في أوروبا بمدينة براغ. ويستند الانتقال جزئياً إلى انتشار Docsy داخل منظومة المشاريع التي ترتبط بالمؤسسة؛ فحتى نهاية 2024 كان نحو 2,200 مشروع يستخدمونه، من بينها مشاريع في Cloud Native Computing Foundation مثل Kubernetes وOpenTelemetry وgRPC وJaeger.
مشروع توثيق يتجه إلى جمهور آلي
أُعلن عن Docsy للمرة الأولى في 2019، وهو قالب مفتوح المصدر مخصص للتوثيق التقني ويمكن استخدامه مع المشاريع المفتوحة أو الخاصة. لكن التغييرات الأخيرة تركز على طريقة وصول أدوات الذكاء الاصطناعي إلى المحتوى، وعلى شكل التعليمات التي تحتاجها هذه الأدوات لتنفيذ مهام مرتبطة بالمشاريع.
منذ الإصدار 0.15.0 في مايو، يستطيع Docsy إنشاء نسخة Markdown من كل صفحة إلى جانب نسخة HTML المعتادة، كما يمكنه توليد ملف llms.txt يوفر فهرساً لمحتوى الموقع. وكلتا الميزتين اختيارية وتجريبية.
وفي الإصدار 0.16.0، الصادر في يوليو، أضيف دليل ترقية صيغ بحيث يستطيع المساعد الآلي اتباعه، مع تضمين الشروط والخطوات وعمليات التحقق. أما الإصدار 0.17.0، الصادر في أغسطس، فأضاف توجيهاً مخفياً أعلى كل صفحة للمستخدمين الذين يفعّلون llms.txt، ليقود الوكلاء الزائرين إلى فهرس الموقع. وتظل هذه الخاصية تجريبية أيضاً.
ما الذي يتغير عملياً؟
يحوّل Docsy جزءاً من مهمة تحسين التوثيق من مجرد تنسيق صفحات للقراءة البشرية إلى تنظيم المحتوى بحيث تستطيع النماذج والوكلاء العثور عليه وفهمه واتباعه. وبالنسبة للمشاريع التي تعتمد على مساهمين أو مستخدمين خارجيين، قد يعني ذلك توجيه أدوات الذكاء الاصطناعي إلى نسخة أكثر وضوحاً من التعليمات بدلاً من تركها تستنتجها من صفحات HTML العامة.
تقول McKean إن توثيقاً أفضل يمكن أن يقلل الأسئلة الروتينية التي تصل إلى المشرفين، لأن الإجابات تصبح متاحة للمستخدمين قبل تدخل maintainer. هذه فائدة تشغيلية محتملة للمشاريع، لكنها لا تعني بحد ذاتها أن الوكلاء سيفهمون المحتوى بصورة صحيحة أو أن الوثائق ستصبح دقيقة تلقائياً.
الخطوة التالية: قياس قابلية القراءة لل agents
يعمل فريق Docsy على ما يسميه AF documentation scores، أي درجات لمدى ملاءمة الوثائق للوكلاء. الهدف هو منح المشرفين مقياساً لتقييم قدرة أدوات الذكاء الاصطناعي على اكتشاف الوثائق والتنقل فيها واستهلاكها، بدلاً من الاكتفاء بالتخمين.
لا يوضح المصدر بعد شكل هذا المقياس أو معاييره النهائية أو موعد إطلاقه. كما أن ميزات Markdown وllms.txt والتوجيهات المرتبطة به اختيارية وتجريبية، لذلك يبقى أثرها العملي معتمداً على تبني المشاريع لها وعلى جودة المحتوى الأصلي الذي تنتجه.
كيف أعددنا هذا الخبر؟
اعتمد الخبر على المصدر الأصلي الموضح أعلاه. قد نستخدم أدوات آلية للمساعدة في الاستخراج والتصنيف والصياغة،
لكن النشر يخضع لقواعد تمنع المحتوى المكرر والقصير أو الروتيني منخفض القيمة.
اقرأ سياستنا التحريرية.