add API documentation, remove #consume!