Improve commentary on the more complex code blocks

[brian-rose]

From @r-ford's review (ProjectPythia/cookbook-gallery#36):

For relatively complex algorithms, I understand the need for the large code blocks, but it would help to have more comments throughout the algorithm explaining what is happening

Something for future improvement!