added a few points to the documentation