توضيحات - اطلاعاتي در برنامه ي کامپيوتري که توسط کامپيوتر ناديده گرفته مي شود و فقط براي توضيح برنامه به کار مي رود . زبانهاي گوناگون کامپيوتري توضيحات را با علائم خاصي معرفي مي کنند، مانند REM , ; , C يا /* * / . همچنين توضيحات را مي توان براي غيرفعال کردن موقتي برخي از فرمانهاي برنامهبه کار برد . وقتي برنامه اي را اصلاح مي کنيد ؛ نگهداري شکل اصلي موضوع تغيير يافته در يک توضيح بسيار مناسب است ؛ زيرا در صورت نياز مي توان مجدداً آنها را فعال کرد . در مورد به کارگيري توضيحات ، نظرات متفاوتي وجود دارد . برخي از نرم افزارهاي مهندسي ، توضيحات اندک را توصيه مي کنند. اين پيشنهاد درست است ، اما درک برنامه بدون توضيحات مناسب پس از ماهها و سالها - حتي براي نويسنده ي آن دشوار خواهد بود . در اينجا چند قانون عام براي استفاده مؤثر از توضيحات در برنامه را ارائه مي دهيم : (1) هر برنامه ، رويه ( زير برنامه) ، يا عملکرد را با يک توضيح شروع کنيد و بنويسيد که چه کاري انجام مي شود . (2) توضيحات را براي پاسخگويي پرسشهاي احتمالي خواننده بنويسيد . (3) مسائل بديهي را توضيح ندهيد. (4) از توضيحات گمراه کننده بپرهيزيد . (5) براي هر خط برنامه به زبان اسمبلي يک توضيح بنويسيد ؛ زيرا خواندن زبان اسمبلي مشکل است ؛ البته مسائل بديهي را توضيح ندهيد.