[weld-issues] [JBoss JIRA] Updated: (CDI-76) JavaDocs regarding adding scopes are weak

JavaDocs regarding adding scopes are weak ----------------------------------------- Key: CDI-76 URL: https://issues.jboss.org/browse/CDI-76 Project: CDI Specification Issues Issue Type: Feature Request Components: Javadoc and API Affects Versions: 1.0 Reporter: Lincoln Baxter III 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.