inline doc improvments