Maybe that comment in addition to mine about alignment should be bullet points.  Any thoughts?

* Use multi-line hashes when it makes the code more readable, and use
  trailing commas to ensure that parameter changes don't cause
  extraneous diff lines when the logic has not otherwise changed.  Multi-line
  hashes should be aligned on the hashbang (`=>`).  It is preferable to sort your keys if order is not relevant.

or

* Use multi-line hashes when it makes the code more readable, and use
  trailing commas to ensure that parameter changes don't cause
  extraneous diff lines when the logic has not otherwise changed.  
* Multi-line hashes should be aligned on the hashbang (`=>`).  
* If order doesn't not matter it is preferable that keys be sorted.