Update Documentation

added a few pointers to self about how to structure the documentation.