It gets included in some pull requests, so keep it short, and refer to the wiki. The wiki page needs to be less off putting too, but that's for another day.