This document discusses making examples and tutorials more accessible. It notes that JBoss Tools had over 1 million starts from August to October 2011, with 81% of users on Windows, 15% on Linux, and 4% on Mac. It recommends the JBoss AS 7 Quick Starts on GitHub and the JBoss AS 7 Getting Started Developing Applications Guide as the most accessible examples for learning how to develop applications on JBoss AS 7.
24. JBoss AS 7 Quick Starts
https://github.com/jbossas/quickstart
https://docs.jboss.org/author/display/AS7/Getting
+Started+Developing+Applications+Guide
Notes de l'éditeur
Examples are projects that are used to present some key aspect of your framework or distribution. The idea of these examples is to show users how your cool technology works so the more accessible they are the better, right?\n
One part is the build system - which one should your examples use?\nLets take a few uses. One thing we need is to solve...\n
...dependencies. Somehow examples should run on users system and how do they know which version of various jars needs to be used? so there has to be a dependency mechanism - so what does that mean for our build tool choice?\n
Ant goes away - sure you can add custom stuff to it but thats custom. Ant+Ivy could work pretty well in this case...but...\n
...we also don’t want any voodoo. By voodoo I mean magic build scripts that does alot of custom setup, resource property replacement, call out to custom scripts etc. especially since when try use it in various IDE’s these aren’t well recognized...so..\n
Ivy now goes away - at least Gradle has a programmatic api to access its project model and Maven has a declarative model which allows IDE’s to at least get near perfect integration. \n\n
on the topic of IDE’s - here are a good set of the IDE’s used out there in the wild - there is alot more but lets say these are a good set of whats used in java opensource.\n
Here is what many framework core devs at JBoss seem to think developers are doing, but reality is more like...\n
this...eclipse keeps showing up in IDE statistics as the most used IDE out there and even netbeans is more used than intellij. So in that context - how does the build tools work in these..\n
...gradle unfortunately doesn’t work in these (yet) so what is left is Maven.\n
here we are seeing from where in the world users of jboss tools are coming from. notice the clusters of people in Brazil and China..\n
looking at more data from these an interesting fact can be deduce - that there is something a vast majority of users are all doing - any guess on what that is ? <click> Yup, you are right - majority runs on windows (note, the same pattern shows up when looking at browsers hitting jboss.org)\n
So to conclude - the most accessible example should\nUse maven as its build system, Be working from eclipse, been tested and run on windows and the language for docs should be Portugese or/and Chinese - just kidding, English is by far the dominant shared language all between.\nIf you want to see on some good examples of quickstarts that follows this take a look at the JBoss AS 7 quickstarts done by Pete Muir and others - thanks!\n
So to conclude - the most accessible example should\nUse maven as its build system, Be working from eclipse, been tested and run on windows and the language for docs should be Portugese or/and Chinese - just kidding, English is by far the dominant shared language all between.\nIf you want to see on some good examples of quickstarts that follows this take a look at the JBoss AS 7 quickstarts done by Pete Muir and others - thanks!\n
So to conclude - the most accessible example should\nUse maven as its build system, Be working from eclipse, been tested and run on windows and the language for docs should be Portugese or/and Chinese - just kidding, English is by far the dominant shared language all between.\nIf you want to see on some good examples of quickstarts that follows this take a look at the JBoss AS 7 quickstarts done by Pete Muir and others - thanks!\n
So to conclude - the most accessible example should\nUse maven as its build system, Be working from eclipse, been tested and run on windows and the language for docs should be Portugese or/and Chinese - just kidding, English is by far the dominant shared language all between.\nIf you want to see on some good examples of quickstarts that follows this take a look at the JBoss AS 7 quickstarts done by Pete Muir and others - thanks!\n
So to conclude - the most accessible example should\nUse maven as its build system, Be working from eclipse, been tested and run on windows and the language for docs should be Portugese or/and Chinese - just kidding, English is by far the dominant shared language all between.\nIf you want to see on some good examples of quickstarts that follows this take a look at the JBoss AS 7 quickstarts done by Pete Muir and others - thanks!\n
So to conclude - the most accessible example should\nUse maven as its build system, Be working from eclipse, been tested and run on windows and the language for docs should be Portugese or/and Chinese - just kidding, English is by far the dominant shared language all between.\nIf you want to see on some good examples of quickstarts that follows this take a look at the JBoss AS 7 quickstarts done by Pete Muir and others - thanks!\n
So to conclude - the most accessible example should\nUse maven as its build system, Be working from eclipse, been tested and run on windows and the language for docs should be Portugese or/and Chinese - just kidding, English is by far the dominant shared language all between.\nIf you want to see on some good examples of quickstarts that follows this take a look at the JBoss AS 7 quickstarts done by Pete Muir and others - thanks!\n
So to conclude - the most accessible example should\nUse maven as its build system, Be working from eclipse, been tested and run on windows and the language for docs should be Portugese or/and Chinese - just kidding, English is by far the dominant shared language all between.\nIf you want to see on some good examples of quickstarts that follows this take a look at the JBoss AS 7 quickstarts done by Pete Muir and others - thanks!\n