Merge pull request #634 from OAI/issue-578

added clarification on namespaces, characters in definitions name