started adding some docs, added a stub for Total