Review public API documentation

Now that we have some documentation being generated, we should review our public API documentation and make it consistent.