Kommentarer och kodläsbarhet

Flerradskommentarer kan skrivas med hjälp av tre citattecken (''' eller """). Till exempel:

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

Kommentarer hjälper till med:

• Att förklara komplex kod.
• Att göra koden lättare att förstå för andra och ert framtida jag.
• Felsökning och problemlösning.

Kom ihåg att kommentarer är till för människor, inte för maskinen!

Här är några tips för att skriva bra kommentarer:

• Håll kommentarerna kortfattade och meningsfulla.
• Undvik uppenbara kommentarer som # Increment x by 1 för x = x + 1.
• Använd kommentarer för att förklara varför koden är skriven på ett visst sätt.

Läsbar kod är enklare att underhålla och felsöka. Här är några tips:

• Använd beskrivande namn på variabler och funktioner.
• Håll kodraderna korta.
• Organisera koden i avsnitt med hjälp av kommentarer.

Ni kan använda kommentarer för att tillfälligt inaktivera kod i felsökningssyfte. Till exempel:

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

Ni kan använda kommentarer för att dokumentera funktioner och förklara deras syfte:

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

greet("Alice")

I den här lektionen har du lärt dig:

• Hur du skriver kommentarer på en rad och på flera rader i Python.
• Varför kommentarer är viktiga för kodens läsbarhet och underhållbarhet.
• Bästa praxis för att skriva kommentarer och förbättra kodens läsbarhet.

Bra jobbat! Nu går vi vidare till nästa ämne.