fix types and add notes section