#114 improve our understanding of the annotation pipeline and fix several bugs. Documentation should be updated as well.