annotations and joe documentation finished