Updated documentation

Someone has to do it... still many, many TODOs but more than nothing is
already good.