renamed README to pick up markdown rendering from github
attempted markdownification of README
cleaned up javadocs by replacing <code>...</code> with {@code ...}
replace <code> with @code
trivial change to README.md
Merge branch 'master' into dev
added some new attributes

Conflicts:
	README.md