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

Making Examples Accessible

on

  • 343 views

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

Statistics

Views

Total Views
343
Views on SlideShare
343
Embed Views
0

Actions

Likes
0
Downloads
0
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Apple Keynote

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment
  • 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 ? 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

Making Examples Accessible Making Examples Accessible Presentation Transcript

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