Improve documentation of conventions