Glasskube تنتقل من Docusaurus إلى Starlight لوثائقها التقنية
2025-05-27
يشارك فيليب، وهو مهندس في Glasskube، تجربته في نقل إطار عمل وثائقهم التقنية من Docusaurus إلى Starlight. تنشر هذه المقالة مقارنة مفصلة بين الإطارين من حيث التصميم، وتحسين محركات البحث (SEO)، وتجربة المطور، وسرعة البناء، وقابلية التوسعة. يعاني Docusaurus، القائم على React، من أوقات بناء أبطأ وقابلية تخصيص محدودة؛ بينما يوفر Starlight، القائم على Astro، أوقات بناء أسرع ودعمًا لـ Tailwind CSS، ولكنه يفتقر إلى تكامل Mermaid ووظائف صفحات التسويق. اختارت Glasskube في النهاية Starlight لتجربة المطور الأفضل والمظهر الأكثر حداثة، على الرغم من بعض العيوب. تشارك المقالة أيضًا الدروس المستفادة من كتابة الوثائق التقنية، بما في ذلك الهيكل، وتحليل سلوك المستخدم، وأسلوب الكتابة، مع التركيز على الوضوح والإيجاز.
التطوير
اختيار الإطار