some progress on documentation