Improve docs for openvasd http v1 API

Use markdown for all sources.

Author: bjoernricks

docs/api/health.rst

@@ -0,0 +1,16 @@
+(http)=
+
+# HTTP APIs
+
+```{eval-rst}
+.. automodule:: gvm.protocols.http
+```
+
+The following modules are provided:
+
+```{eval-rst}
+.. toctree::
+    :maxdepth: 1
+
+    openvasdv1
+```

docs/api/http.md

@@ -0,0 +1,18 @@
+(openvasdv1)=
+
+# openvasd v1
+
+```{eval-rst}
+.. automodule:: gvm.protocols.http.openvasd
+    :members:
+```
+
+```{toctree}
+:hidden:
+
+openvasdv1/health
+openvasdv1/metadata
+openvasdv1/notus
+openvasdv1/scans
+openvasdv1/vts
+```

docs/api/http.rst

@@ -0,0 +1,6 @@
+# Health API
+
+```{eval-rst}
+.. automodule:: gvm.protocols.http.openvasd._health
+   :members:
+```

docs/api/metadata.rst

@@ -0,0 +1,6 @@
+# Metadata API
+
+```{eval-rst}
+.. automodule:: gvm.protocols.http.openvasd._metadata
+   :members:
+```

docs/api/notus.rst

@@ -0,0 +1,6 @@
+# Notus API
+
+```{eval-rst}
+.. automodule:: gvm.protocols.http.openvasd._notus
+   :members:
+```

docs/api/openvasdv1.md

@@ -0,0 +1,6 @@
+# Scans API
+
+```{eval-rst}
+.. automodule:: gvm.protocols.http.openvasd._scans
+   :members:
+```

docs/api/openvasdv1.rst

@@ -0,0 +1,6 @@
+# VTs API
+
+```{eval-rst}
+.. automodule:: gvm.protocols.http.openvasd._vts
+   :members:
+```

docs/api/openvasdv1/health.md

@@ -11,6 +11,7 @@
 
 gmp
 ospv1
+http
 ```
 
 ## Dynamic

docs/api/openvasdv1/metadata.md

@@ -5,8 +5,5 @@
 """
 Package for supported Greenbone HTTP APIs.
 
-Currently only `openvasd version 1`_ is supported.
-
-.. _openvasd version 1:
-    https://greenbone.github.io/scanner-api/#/
+Currently only `openvasd version 1 <https://greenbone.github.io/scanner-api/#/>`_ is supported.
 """

docs/api/openvasdv1/notus.md

@@ -3,13 +3,14 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """
-Package for sending requests to openvasd and handling HTTP API responses.
-
-Modules:
-- :class:`OpenvasdHttpApiV1` – Main class for communicating with OpenVASD API v1.
+High-level API interface for interacting with openvasd HTTP services via
+logical modules (health, metadata, scans, etc.).
 
 Usage:
-    from gvm.protocols.http.openvasd import OpenvasdHttpApiV1
+
+.. code-block:: python
+
+    from gvm.protocols.http.openvasd import OpenvasdHttpAPIv1
 """
 
 from ._openvasd1 import OpenvasdHttpAPIv1