cwebber2tantek: sandro's warning is a good one to heed, once you publish a note and we close we don't get to update it... so capturing "these implementations implement this at this point in time" rather than "this is the right way to do it for all time"
