> If it's possible to put some of these in code comments, I think that'd make it much more readable. Otherwise, a little more structure/breakdown in the paragraph would be helpful too.

I think this list does a better job that the previous paragraph, what do you think?