added some remarks to the documentation