better docblocks
worked a bit on documentation
prepare the reader for the import