cdi-spec / cdi-spec.org Goto Github PK

Many pages are missing own title, which leads to weird content ot the <title> element and weird title shown in the browser, eg. http://www.cdi-spec.org/download/ , http://www.cdi-spec.org/ecosystem/ etc.

I did not want to change the current FAQ entries for interceptors and AFTER_SUCCESS observers in my fork before asking:

It seems both sections do not align to the latest CDI 1.1/JTA 1.2 and Interceptor 1.2 specs. The observer section should probably refer to @transactional, interceptors should mention @AroundConstruct and LifeCycle interception.

We should either remove this info or keep it up to date. It would be also great to show the CDI version along the implementation.

The latest version of CDI is 1.2...

Should we refer to the jboss beans.xsd location? I still would prefer http://java.sun.com/xml/ns/javaee/beans_1_0.xsd (which redirects to http://www.oracle.com/webfolder/technetwork/jsc/xml/ns/javaee/beans_1_0.xsd)?

The source code layout seems to be broken - apart from the first line every other lines starts with a deep indent.

We should auto-generate links like http://www.cdi-spec.org/faq/#model_annotation for each FAQ item, and have that open the right accordion item

I a recent FAQ entry I referred new users to the Oracle CDI tutorial. The tutorial is pretty bad in my opinion, nevertheless it is better than no tutorial. Right now I don't have the time to create a "neutral" tutorial from scratch. Neutral in terms of CDI implementation.

Do you have something somewhere available that can be placed at cdi-spec.org easily? I am available to convert an existing tutorial, creating one from scratch is impossible time-wise.

Should you add short page description to the head of each page in form of meta tag please, so we can use it for search (https://issues.jboss.org/browse/ORG-2763)

Frequently asked questions at http://www.cdi-spec.org/faq/ are outdated - mostly in sync with CDI 1.0 or CDI 1.1.

Copied from https://issues.jboss.org/browse/CDI-435.

I would recommend to change the order of the FAQ entries and start with

What is +beans.xml+ and why do I need it?
Where is the XSD for beans.xml located?
Should I use javax.faces.bean.SessionScoped or javax.enterprise.context.SessionScoped?
How do I use the conversation scope with JSF 2?
What is the purpose of the @model annotation?
Why is the constructor invoked twice when a normal scoped bean is created?
When are interceptors and decorators applied?
...

Looking at http://www.osgi.org/Technology/WhyOSGi I think the CDI website could sport a similar page.

I believe most of the reasons for choosing CDI over other technologies have been exposed at different locations. Putting them under one roof makes it easier to convince non-tech people (e.g. CTOs) of the advantages of choosing CDI over its competitors 😄

Hi, I'm working on indexer/crawler which allows to index content of weld website for the search (see
https://issues.jboss.org/browse/ORG-2763). Problem is that there is not any unique css selector which allows to get real content of the page, without all the common stuff (header, main menu, footer). Getting real content only can improve search relevance.
Should you add some unique css class, eg. content-wrapper to the div which contains real content of the page please?