add alternative default value argument to AnnotationsBag::get + tests
update some docblocks