Avatar ·

هل يدعم Swift إنشاء الوثائق؟ هل هناك أدوات مدمجة؟

مرحباً بالجميع! أنا مطور iOS مبتدئ وأكتب بلغة Swift منذ حوالي ستة أشهر. مؤخراً واجهت مشكلة: مشروعي كبر وأصبحت أخلط بين دوالي وطرقي الخاصة. كنت سابقاً أكتب تعليقات مثل `// هذه دالة لتحميل البيانات`، لكن هذا غير مريح — أضطر للنظر في الكود باستمرار.\n\nسمعت أنه في بعض اللغات (مثل Java مع JavaDoc أو Python مع Sphinx) توجد أدوات مدمجة لإنشاء وثائق جميلة مباشرة من التعليقات. أتساءل إن كان هناك شيء مشابه في Swift؟ هل يمكن إنشاء وثائق HTML تلقائياً لمشروعي، لأتمكن من رؤية وصف جميع الـ classes والـ methods والـ properties بسرعة؟\n\nجربت كتابة تعليقات بأسلوب `/// هذه الخاصية تخزن اسم المستخدم`، لكنني لا أعرف إن كان هذا يعمل بطريقة ما.