fixed a few javadoc comments and added a bit to contributing.md