minor: docs converting definitions to definition list forms