add intro paragraph and replace unicode characters with html entities

Small update to docs.