document that offsets are preallocated
document the append option
add another TODO about max_app_chunks
fix a typo in a docstring