Documentation best practices

shape