Use sphinx tags for Python doc annotations

Currently, pyspark documentation uses the same annotations as in Scala:

:: Experimental ::

It should use Sphinx annotations:

.. note:: Experimental

The latter method creates a box. The former method must either be on the same line as the rest of the doc text, or it generates compilation warnings.

Proposal: Change all annotations in Python docs to use "note"