docs: start adding docstrings to functions
    
    I don't have enough energy to do this for all functions, but I'll try
    to add some docs as I look at the code. The project is growing and it's
    harder to remember what all the parts do.