slightly improve stub and fill methods
add complete class documentation
add complete class documentation