Expand write API documentation

Happy Christmas, here's some API documentation :christmas_tree: