cleanup and documentation
update spec for publishing