documentation: update the CODING STYLE document

To reflect that new docstrings should use reStructuredText and
other Sphinx tags.

Signed-off-by: Cleber Rosa <crosa@redhat.com>