add documentation of conventions