added useful documentation