yes we need some `package-info` global JavaDoc describing how everything fit together as well as per method JavaDoc to know where to go.