improved documentation; added an additional test