Bring documentation to a useful state

[schrer]

• Any Interface has to be fully documented, classes that do not have interfaces, or methods that or not defined in an interface should also be fully documented with JavaDoc.
• The README has to be regularly checked for any necessary or useful updates.