added debug outline
moved docs to notes