في بحثك عن برمجيات الويكي المتاحة، واستناداً إلى صفحات مثل مقارنة برمجيات الويكي في ويكيبيديا، تبحث عن حل يلبي عددًا من المتطلبات، ولكن لم تتمكن حتى الآن من العثور على شيء مناسب. تهدف إلى إنشاء موقع توثيق بشكل يشبه توقيعات TechNet أو MSDN، أو مثل موقع الوثائق الخاص بـ RedGate. على الرغم من أن هذا يمكن أن يتم باستخدام موقع SharePoint أو ويكي تقليدي مثل ميدياويكي، فإن هذه الأخيرة عمومًا مخصصة للمحتوى المفتوح والمحرر من قبل المجتمع والذي يتطور بسرعة، أو للوثائق الداخلية في الشركة حيث لا يُعتبر وجود أخطاء أو محتوى غير كامل مشكلة. في هذه الحالة، ستكون الوثائق مرئية للعملاء عبر الإنترنت وستتم مراجعتها فقط من قبل موظفينا، لذا سيكون من المفضل أن يكون محتواها مُوَجَّهاً بالشكل ومُستعمَلاً في التحكم بالمصدر واستخدام إدارة الإصدارات لبيئات مختلفة (مثل موقع DEV حيث يحرر موظفونا المحتوى، وموقع TEST للقراءة التجريبية، وموقع LIVE على الإنترنت للجمهور) بحيث لا يكون المحتوى النصف مكتمل، أو المحتوى الذي لم يتمتع بالتدقيق يظهر فورًا كما هو الحال في الويكي القياسي، ولكن أيضًا من الضروري السماح للموظفين بتحرير الوثائق بسرعة بتنسيق ويكي.
أنا على علم بأن هناك مشاريع مثل Sandcastle و Document! X و Doxygen، التي تولد وثائق بشكل مباشر من الشيفرة المصدرية على غرار MSDN، ولكن لا تنوي أن تكون هذه موقعًا للتوثيق مولَّدة من تعليقات الشيفرة المصدرية، ولكن واحدة تحتوي على مقالات مكتوبة. في جوهرها، أنا أبحث عن برمجيات توفر:
- سهولة استخدام الويكي – يمكن لأي شخص تسجيل الدخول إلى موقع DEV وإضافة/تحرير المحتوى.
- التحكم بالمصدر لجميع المحتويات، على الأرجح ملفات Markdown والصور، ليس في قاعدة بيانات، حيث يتم تحديث المصدر (TFS) تلقائيًا/تسجيل الملفات/تسجيل الخروج، بواسطة إمكانيات تحرير الويكي المبسَّطة المذكورة أعلاه.
- نتيجة للنقاط السابقة، القدرة على “إصدار” الوثائق إلى بيئات الاختبار والإنتاج، كما تفعل مع أي حل موقع ويب آخر.
أمثلة إضافية ستكون مواقع مثل https://uk.mathworks.com/help أو https://docs.python.org/3/tutorial/introduction.html. هل يمكن لأي شخص تقديم معلومات حول ما إذا كان مثل هذا الحل متاحًا، أو شرح كيفية إدارة مواقع مثل MSDN، أو TechNet، أو موقع الوثائق الخاص بـ RedGate والتطبيقات المستخدمة لها؟
المزيد من المعلومات
بالطبع، دعنا نستكمل النقاش حول حلول إدارة الوثائق عبر الإنترنت بما يتماشى مع متطلباتك المحددة.
لإدارة مواقع التوثيق الكبيرة والمعقدة مثل MSDN، TechNet، وموقع الوثائق الخاص بـ RedGate، يتم استخدام أدوات وتقنيات متقدمة لضمان سلاسة التحرير، والتحكم بالإصدارات، ونشر المحتوى بطريقة منظمة ومنسقة.
أولاً، يمكن استخدام أنظمة إدارة المحتوى (CMS) المتقدمة مثل Drupal أو WordPress مع الإضافات المناسبة لإدارة وثائق البرمجيات. توفر هذه الأنظمة قدرات تحرير الويكي بسهولة، وتدعم التحكم بالإصدارات، وتوفر واجهات برمجة التطبيقات (APIs) للتكامل مع أنظمة إدارة الإصدارات مثل Git أو TFS.
ثانيًا، يمكن استخدام أنظمة إدارة الوثائق مثل SharePoint لإنشاء وثائق المؤسسة بشكل متقدم ومنظم، ويمكن تكوينها لتوفير سيناريوهات التحكم بالإصدارات ومراجعة المحتوى قبل النشر.
ثالثًا، يمكن استخدام أنظمة إدارة الشفرة مثل GitLab أو Bitbucket للتحكم بالمصدر والإصدارات، مع دمج أدوات الويكي المدمجة لتوثيق المشاريع وإدارتها.
بالإضافة إلى ذلك، يمكن استخدام أدوات تحرير الويكي المتقدمة مثل MkDocs أو Docusaurus مع إدارة الإصدارات عبر Git لإنشاء مواقع توثيق سهلة الاستخدام ومنظمة.
باختصار، هناك العديد من الخيارات المتاحة لإنشاء مواقع توثيق متقدمة تلبي احتياجاتك، ويمكن تخصيص الحلول وفقًا لمتطلباتك الخاصة بالوثائق والإصدارات والتحكم بالمصدر. يُوصى بمراجعة كل حل بعناية وفقًا للأهداف والمتطلبات الفردية للمشروع.
