add convention to docs