8:31 a.m.
All,
For jdf 2.0 we want to introduce a new top level area to the site, "How do I?".
Reviewing the existing areas:
* Quickstarts: small, runable apps which show how to use an API
* Examples: larger runable apps, which show how to fulfil a range of use cases
* Migration guides
* Stacks: recommended stacks of libraries and frameworks to use together
We quickly realised we had nowhere we could address questions like:
"How do I add RichFaces to my application?
You created a Java EE application using JBDS, and now you want to add RichFaces"
"How do I build a new HTML5 application, and get it deployed to the cloud, all in ten
minutes?
You're interested in the RAD options that JBoss offered, and want to see how to get
started"
"How can I make the most of OpenShift with JBoss?
You're used to JBoss software, and want to explore how OpenShift can help
you"
We're proposing to add a new top level area, named "How do I?" that contains
articles that address each of these topics.
Initially, we have identified these questions as the ones that we want to answer (either
because they question always comes up, or because we already have material for it). In the
list below, I've volunteered people to take some of the topics, and if anyone else can
help out, that would be much appreciated.
"How do I add RichFaces to my application?
You created a Java EE application using JBDS, and now you want to add RichFaces"
<--- Brian Leatham/RichFaces team (I'm not aware of any content we have today)
"How do I create a new RichFaces application?
You're just starting out, and want to create a new RichFaces application"
<--- Brian Leatham/RichFaces team (Based on archetype via JBDS)
"How do I add Errai to my application?
You created a Java EE application using JBDS, and now you want to add Errai"
<--- Lincoln Baxter/Errai team (I'm not aware of any content we have today)
"How do I create a new Errai application?
You're just starting out, and want to create a new Errai application" <---
Lincoln Baxter/Errai team (Based on archetype via JBDS)
"How do I add HTML5 to my application?
You created a Java EE application using JBDS, and now you want to add HTML5"
<--- Marius Bogoevici (I'm not aware of any content we have today)
"How do I create a new HTML5 application?
You're just starting out, and want to create a new HTML5 application" <---
Jay Balunas/Aerogear team (Based on archetype via JBDS)
"How do I build a new HTML5 application, and get it deployed to the cloud, all in ten
minutes?
You're interested in the RAD options that JBoss offered, and want to see how to get
started" <--- Pete Muir (based on the demo that Pete and Marius did at JBoss World
2012)
"How can I make the most of OpenShift with JBoss?
You're used to JBoss software, and want to explore how OpenShift can help you"
<-- Pete Muir (based on Pete's JBoss + OpenShift RAD talk)
Any other topics, please let us know :-)
Obviously, we are still establishing this an area, so we don't have 100% locked down
the format, content types etc. My proposal is that we offer at least:
* the question, and the short use case that the person is trying to walk through (as
I've written out here)
* an article, walking the person through the solution, including screenshots, sample
output etc. where relevant
* a video, showing the person the solution
and optionally:
* a script, which walks someone who is trying to do a demo, the necessary steps
* presenter notes, which highlight key things to talk about whilst doing the demo
Of course, JBDS should be used throughout.
"Volunteers", please let me know if you are ok with this :-) We would be looking
for this to be done by the end of August. I will try to do a prototype one soon, to give
some guidance.
Pete