maybe: documentation and API improvements