handle the zero suggestion case
html escape the description so that it renders
explain how to use and log some notes