After discussion on IRC, we've agreed on adding explanation to the document and leaving the document here.