Вот статья в блоге, в которой приведены примеры встроенных комментариев Python:

При написании кода Python важно сосредоточиться не только на функциональности, но также на читаемости и удобстве сопровождения кода. Один из способов добиться этого — использовать встроенные комментарии. Встроенные комментарии — это краткие аннотации, предоставляющие дополнительную информацию о коде и его функциях. В этой статье мы рассмотрим различные методы использования встроенных комментариев в Python, а также примеры кода, которые помогут вам писать более понятный и хорошо документированный код.

Методы и примеры:

1. Комментирование одной строки:

   x = 5  # Assigning the value 5 to variable x

2. Комментарий после кода в той же строке:

   result = some_function()  # Calling some_function and storing the result

3. Комментирование одной и той же строки после кода с несколькими комментариями:

   y = 10  # Assigning the value 10 to variable y; this will be used for calculations later

4. Комментирование нескольких строк кода с помощью блочного комментария:

   # This block of code calculates the sum of two numbers
   num1 = 5
   num2 = 10
   sum = num1 + num2

5. Комментирование внутри строки кода:

   result = x * 2  # Multiply the value of x by 2 and assign it to result

6. Комментирование для объяснения сложного или сложного кода:

   # This code snippet uses list comprehension to filter out even numbers from the given list
   numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
   even_numbers = [num for num in numbers if num % 2 == 0]

Встроенные комментарии — ценный инструмент для улучшения читаемости кода и документации в Python. Они позволяют вам предоставлять дополнительный контекст, объяснения или напоминания в вашем коде. Эффективно используя встроенные комментарии, вы можете сделать свой код более понятным для себя и других разработчиков, которые могут читать ваш код или работать над ним в будущем. Не забывайте использовать комментарии экономно, уделяя особое внимание наиболее важным частям кода, требующим пояснений.