fix docs warning and RTD settings (#1250)

.readthedocs.yaml

@@ -1,21 +0,0 @@
-# .readthedocs.yaml
-# Read the Docs configuration file
-# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
-
-# Required
-version: 2
-
-# Set the version of Python and other tools you might need
-build:
-  os: ubuntu-22.04
-  tools:
-    python: "3.11"
-
-# Build documentation in the docs/ directory with Sphinx
-sphinx:
-   configuration: docs/conf.py
-
-# Optionally declare the Python requirements required to build your docs
-python:
-   install:
-   - requirements: docs/requirements.txt

docs/source/plugins.rst

@@ -67,7 +67,7 @@ The following methods are options to connect a plugin to pygeoapi:
 
 
 Specifying custom pygeoapi CLI commands
-+++++++++++++++++++++++++++++++++++++++
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Third-party plugins may also provide custom CLI commands. This can be done by means of two additional steps:
 
@@ -144,11 +144,6 @@ configuration's ``server.manager.name`` to indicate either the dotted path to th
 manager class (*i.e.* similar to option 1 above) or the name of a known core pygeoapi plugin (*i.e.*, similar to
 option 2 above).
 
-
-
-
-
-
 Example: custom pygeoapi vector data provider
 ---------------------------------------------
 

readthedocs.yml

@@ -1,19 +1,11 @@
-# .readthedocs.yml
 # Read the Docs configuration file
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 
-# Required
 version: 2
 
-# Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/source/conf.py
 
-
-# Optionally build your docs in additional formats such as PDF and ePub
-formats: all
-
-# Optionally set the version of Python and requirements required to build your docs
 python:
   version: 3.7
   install: