The Javadoc for BeanContainer.createInstance() defines its behaviour when called during AfterBeanDiscovery. The Javadoc for BeanManager says it's not valid before AfterBeanDiscovery.
However, the spec (3.9.1) says that it's not valid before AfterDeploymentValidation which is fired after AfterBeanDiscovery.
The spec and the Javadoc disagree here, which one should be changed?