cdi-spec / cdi-spec.org

Sources for cdi-spec.org
18 stars 23 forks source link

Consider FAQ section ordering #2

Closed frenchc closed 11 years ago

frenchc commented 11 years ago

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? ...

pmuir commented 11 years ago

@frenchc I added ordering support to the FAQ module. Now just prepend the FAQ entry with a number, and earlier numbers will appear earlier.

Do you want to propose an order by adding numbers? See 1-what-is... for example

LightGuard commented 11 years ago

NOTE: This was slightly changed with the commits I did. You now need an order attribute in the asciidoc file, instead of the name of the file.

pmuir commented 11 years ago

Jason, are you sure that is better? Having the order as part of the filename means you can easily see the order by doing an ls rather than having to open every file.

LightGuard commented 11 years ago

We could go back fairly easily, just seemed like it was metadata for the actual FAQ, which IMO belongs in the file, not part of the name. I can understand your thoughts though.  — Sent from Mailbox for iPhone

On Fri, Apr 26, 2013 at 1:42 AM, Pete Muir notifications@github.com wrote:

Jason, are you sure that is better? Having the order as part of the filename means you can easily see the order by doing an ls rather than having to open every file.

Reply to this email directly or view it on GitHub: https://github.com/cdi-spec/cdi-spec.org/issues/2#issuecomment-17059546

frenchc commented 11 years ago

I was about to work on that later the day. So you have approx. 10 hours to change it back- and forwards;).

We should support ranges, e.g. basic faq issues start at 1, more advanced at 100 and fairly advanced things (such as the SFSB observer TX issue) at 500. From what I saw it should work already.

frenchc commented 11 years ago

I started reordering the FAQ entries.Fixed ordering itself - as usual it was a string sort;).

Will create a pull request shortly.

(Why do I need to understand ruby, haml and seconds later slim these days;).

frenchc commented 11 years ago

See pull request in issue #6.