dev guide updates:
1) check-in javadocs until we can get them genned properly at build time
2) programmers ref: annotation files