documentation added (part III)