JavaDocs regarding adding scopes are weak

JavaDocs for adding scopes via the eventing API are a bit weak.

public void addScope(@Observes final BeforeBeanDiscovery event)

{ event.addScope(ProjectScoped.class, true, false); }

Currently it is not clear that using this method is only required when not using the @NormalScoped annotation, and that it will in fact override the annotation if present. Additional docs should probably be placed on both sides of this relationship, to that affect.