another swing at documentation formatting