[cdi-dev] [JBoss JIRA] Closed: (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: Clarification Components: Javadoc and API, Portable Extensions Affects Versions: 1.0 Reporter: Lincoln Baxter III Assignee: Pete Muir Fix For: 1.1 (Confirmed) 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.