moved diagrams into doc dir, created doc/javadoc subdir, updated doc script, added javadocs to asciidoc readme