adding more documentation to common classes