additional API documentation to aid in code re-use