add documentation and update metadata