Avatar ·

أين يمكنني العثور على وثائق حول بناء جملة التعليقات في TypeScript؟

مرحباً بالجميع! لقد بدأت للتو في تعلم TypeScript، وانتقلت من JavaScript. في JavaScript كنت معتاداً على استخدام التعليقات لشرح الكود الخاص بي، لكن في TypeScript واجهت بعض الارتباك. أعلم أن هناك `//` للتعليقات أحادية السطر و`/* */` للتعليقات متعددة الأسطر، لكنني سمعت أن TypeScript يحتوي على بعض التعليقات "الخاصة" المستخدمة للأنواع أو التوثيق أو شيء من هذا القبيل. على سبيل المثال، رأيت في كود شخص آخر شيئاً مثل `/** @param {string} name */` قبل دالة. هل هذا TypeScript صالح؟ أم أنه مجرد JSDoc؟ حاولت البحث عن "TypeScript comments syntax" لكنني أجد فقط مقالات عامة حول تعليقات JavaScript. أين بالتحديد في الوثائق الرسمية لـ TypeScript يتم وصف جميع أنواع التعليقات؟ هل توجد صفحة خاصة بالبناء الجملة؟ إليك مثال على الكود الخاص بي حيث أحاول استخدام التعليقات، لكنني لست متأكداً مما إذا كنت أفعل ذلك بشكل صحيح: ```typescript // هذا مجرد تعليق const x: number = 10; /* تعليق متعدد الأسطر سطر آخر ```