add some api comments (just so i can visually separate the functions
for now)