some documentation updates for the latest changes and excaped some characters