suggestion from Jeremy :
for future releases we should add more comment to the source code (doxygen format) so we can extract the info from the source and create a doxygen API on the website.
this will make it easier for new people to dive into the code and get up to speed