change to lowercase notation
clarify documentation and add to namespace