मैं कुछ पुराने कोड को ब्राउज़ कर रहा था जो मैंने लिखा था (विश्वविद्यालय में प्रथम वर्ष) और मैंने देखा कि मैं कोड के विभिन्न भागों से पहले टिप्पणी शीर्षक लिखता था। सामान की तरह (यह एक एकाधिकार खेल से है):
/*Board initialization*/
...code...
/*Player initialization*/
...code...
/*Game logic starts here*/
/*Displaying current situation*/
...code...
/*Executing move*/
...code...
/*Handle special event*/
...code...
/*Commit changes, switch to next player*/
...code...
यह निरर्थक हो सकता है, और यकीनन अनावश्यक हो सकता है यदि कोड वास्तव में सुपर स्पष्ट है, लेकिन जैसा कि मैंने फ़ाइल के माध्यम से स्कैन किया तो मुझे आश्चर्य हुआ कि मुझे कितना जोर से लगा जैसे मुझे पता है कि क्या हो रहा है भले ही मैंने वास्तविक कोड को देखा हो। मैं निश्चित रूप से कुछ परिस्थितियों में फिटिंग के रूप में देख सकता हूं, इसलिए मुझे आश्चर्य है कि क्या आप ऐसा करते हैं? क्या आपको लगता है कि यह एक अच्छा विचार है? या यह बहुत ज्यादा है?