add documentation and usage helpers