documentation updates, new approach
documentation changes, almost done