adjusted documentation  to have more explicit and intentional use f language