minor inline doc updates and formatting