Update notes for submitted changes

* doc: deploying.rst improvement
Update notes for submitted changes

* Rest syntax fixes