fix doc formatting issues

Author: aaronsilinskas

README.rst

@@ -35,10 +35,11 @@ Please ensure all dependencies are available on the CircuitPython filesystem.
 This is easily achieved by downloading
 `the Adafruit library and driver bundle <https://circuitpython.org/libraries>`_
 or individual libraries can be installed using
-`circup <https://github.com/adafruit/circup>`_.Installing from PyPI
+`circup <https://github.com/adafruit/circup>`_.
+
+Installing from PyPI
 =====================
-.. note:: This library is not available on PyPI yet. Install documentation is included
-   as a standard element. Stay tuned for PyPI availability!
+.. note:: This library is not available on PyPI yet. Install documentation is included as a standard element. Stay tuned for PyPI availability!
 
 On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally `from
 PyPI <https://pypi.org/project/mindwidgets-circuitpython-df1201s/>`_.

mindwidgets_df1201s.py

@@ -124,7 +124,9 @@ def _map_volume(self, volume: float) -> int:
 
     @property
     def connected(self) -> bool:
-        """True if the DFPlayer is connected."""
+        """
+        :return: True if the DFPlayer is connected.
+        """
         return self._send_command("")
 
     def set_baud_rate(self, rate: int) -> bool:
@@ -141,7 +143,9 @@ def set_baud_rate(self, rate: int) -> bool:
 
     @property
     def volume(self) -> float:
-        """Volume level, as a float between 0 and 1."""
+        """
+        :return: Volume level, as a float between 0 and 1.
+        """
         response = self._send_query("VOL", "?")
         df_volume = self._unwrap_int(response[7:-1])
         if df_volume < 0:
@@ -339,25 +343,35 @@ def total_files(self) -> int:
 
     @property
     def file_number(self) -> int:
-        """The file number of the currently playing file."""
+        """
+        :return: The file number of the currently playing file.
+        """
         return self._unwrap_int(self._send_query("QUERY", 1))
 
     @property
     def file_name(self) -> str:
-        """The file name of the currently playing file."""
+        """
+        :return: The file name of the currently playing file.
+        """
         return self._send_query("QUERY", 5)
 
     @property
     def played_time(self) -> int:
-        """The number of seconds the current sound has played."""
+        """
+        :return: The number of seconds the current sound has played.
+        """
         return self._unwrap_int(self._send_query("QUERY", 3))
 
     @property
     def total_time(self) -> int:
-        """The length of the current sound in seconds."""
+        """
+        :return: The length of the current sound in seconds.
+        """
         return self._unwrap_int(self._send_query("QUERY", 4))
 
     @property
     def playing(self) -> bool:
-        """True if a sound is currently playing."""
+        """
+        :return: True if a sound is currently playing.
+        """
         return self.played_time < self.total_time