adding some docblock, moving examples in separate folder, planning on adding test later.