Learning ArcGIS Pro

Some Python basics
Since this is your first introduction to Python, it is a good time to introduce some
fundamentals and best practices. These will serve you well as you begin to write your own
scripts.
Commenting and documenting your scripts
When you begin creating a Python script, it is considered a best practice to include
documentation within the code that will help other developers understand what is
happening within the code and the purpose of specific parts of the script. This can also
prove helpful to yourself if you have to come back to a script you wrote some time ago
and need to make changes.
This code documentation is traditionally accomplished using commenting. Think of
commenting code as a form of metadata stored within the code itself. It provides users and
other programmers with the who, what, where, when, and whys they may need to
successfully use, integrate, or edit a script you create. Different programming languages
use different methods to comment code. Python uses the pound sign (#) to identify
comment lines within its code as illustrated next:
Anytime Python encounters a line that starts with a #, it ignores that line and moves to the
next. It will keep ignoring lines until it encounters one that does not have a # at the
beginning.
It is also possible to use triple double quotations (""") to indicate a multiple line comment.
Any text between the opening and closing triple quotes will be ignored.