updating documentation (via Sami)