updated readme and spec to explain example html section