Making Examples Accessible
Upcoming SlideShare
Loading in...5
×

Like this? Share it with your network

Share

Making Examples Accessible

  • 386 views
Uploaded on

Slides from Lightning talk given at JUDCon London 2011 about how to make examples accessible....

Slides from Lightning talk given at JUDCon London 2011 about how to make examples accessible.

Audio+animated slides available at http://vimeo.com/groups/jbosstools/videos/32501925

More in: Technology , Travel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
    Be the first to like this
No Downloads

Views

Total Views
386
On Slideshare
386
From Embeds
0
Number of Embeds
0

Actions

Shares
Downloads
1
Comments
0
Likes
0

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide
  • 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
  • \n

Transcript

  • 1. Making examples accessible (the short version) Max Andersen
  • 2. 1.000.000+ starts of JBoss Tools August-October 2011
  • 3. 4%15% 81%
  • 4. Windows Linux Mac 4% 15% 81%
  • 5. The most accessible Example...
  • 6. The most accessible Example...
  • 7. The most accessible Example...
  • 8. The most accessible Example...
  • 9. The most accessible Example...
  • 10. The most accessible Example...
  • 11. JBoss AS 7 Quick Starts https://github.com/jbossas/quickstarthttps://docs.jboss.org/author/display/AS7/Getting +Started+Developing+Applications+Guide