Comments और Code की पठनीयता

बहु-पंक्ति टिप्पणियाँ ट्रिपल कोट (''' या """) का उपयोग करके लिखी जा सकती हैं। उदाहरण के लिए:

"""
This is a multi-line comment.
It spans multiple lines.
"""
print("Hello, World!")

टिप्पणियाँ इन कार्यों में मदद करती हैं:

• जटिल कोड को समझाना।
• दूसरों और भविष्य में स्वयं आपके लिए कोड को समझना आसान बनाना।
• डिबगिंग और समस्याओं का समाधान करना।

याद रखें, टिप्पणियाँ इंसानों के लिए होती हैं, मशीन के लिए नहीं!

अच्छी टिप्पणियाँ लिखने के लिए कुछ सुझाव यहाँ दिए गए हैं:

• टिप्पणियों को संक्षिप्त और अर्थपूर्ण रखें।
• x = x + 1 के लिए # Increment x by 1 जैसी स्पष्ट टिप्पणियों से बचें।
• यह समझाने के लिए टिप्पणियों का उपयोग करें कि कोड किसी विशेष तरीके से क्यों लिखा गया है।

पढ़ने योग्य कोड का रखरखाव और डिबगिंग करना आसान होता है। यहाँ कुछ सुझाव दिए गए हैं:

• अर्थपूर्ण चरों और फ़ंक्शन के नामों का उपयोग करें।
• कोड की पंक्तियों को छोटा रखें।
• टिप्पणियों का उपयोग करके कोड को खंडों में व्यवस्थित करें।

डिबगिंग के उद्देश्य से कोड को अस्थायी रूप से निष्क्रिय करने के लिए आप टिप्पणियों का उपयोग कर सकते हैं। उदाहरण के लिए:

# print("This line is commented out and won’t run.")
print("This line will run.")

आप फ़ंक्शन का दस्तावेज़ीकरण करने और उसका उद्देश्य समझाने के लिए टिप्पणियों का उपयोग कर सकते हैं:

def greet(name):
    # This function greets the user by their name.
    print("Hello,", name)

greet("Alice")

इस पाठ में आपने सीखा:

• Python में एक-पंक्ति और बहु-पंक्ति टिप्पणियाँ कैसे लिखें।
• कोड की पठनीयता और रखरखाव के लिए टिप्पणियों का महत्व।
• टिप्पणियाँ लिखने और कोड की पठनीयता सुधारने के सर्वोत्तम अभ्यास।

बहुत अच्छा! अब अगले विषय पर चलते हैं।