Formatting improvements and add code comments on Order API + fix broken URL

Created by: artfulrobot

• Fix broken link to dev/financial#73 (closed)
• Use // for single line comments (isn't # deprecated? or is that just in .ini files?)
• Add whitespace and comments around migration from transact code.
• Wrap code example lines so they display properly