feat: improve document api reference

CHANGELOG.md

@@ -15,6 +15,10 @@
 1. [#180](https://github.com/InfluxCommunity/influxdb3-python/pull/180): Add `flush()` method to `InfluxDBClient3`:
    - Allows flushing the write buffer without closing the client when using batching mode.
    - Enables applications to ensure data is written before querying, while keeping the client open for further operations.
+1. [#185](https://github.com/InfluxCommunity/influxdb3-python/pull/185):
+   - Add API Reference page on document page
+   - Remove old document link.
+   - Add link to document page in README.md
 
 ### Bug Fixes
 

README.md

@@ -4,6 +4,9 @@
 </p>
 
 <p align="center">
+    <a href="https://influxdb3-python.readthedocs.io/en/latest/">
+        <img src="https://img.shields.io/readthedocs/influxdb3-python/latest" alt="Readthedocs document">
+    </a>
     <a href="https://pypi.org/project/influxdb3-python/">
         <img src="https://img.shields.io/pypi/v/influxdb3-python.svg" alt="PyPI version">
     </a>

docs/api_reference.md

@@ -0,0 +1,15 @@
+# API Reference
+
+::: __init__.InfluxDBClient3
+    options:
+        members:
+            - from_env
+            - write
+            - write_file
+            - write_dataframe
+            - query
+            - query_dataframe
+            - query_async
+            - get_server_version
+            - flush
+            - close

docs/mkdocs.yml

@@ -2,5 +2,14 @@ site_name: InfluxDB 3.0 Python Client
 docs_dir: .
 nav:
   - Home: index.md
+  - API Reference: api_reference.md
 plugins:
   - include-markdown
+  - mkdocstrings:
+      handlers:
+        python:
+          paths: [ ../influxdb_client_3 ]
+          options:
+            summary: true
+            show_symbol_type_toc: true
+            show_symbol_type_heading: true

docs/requirements.txt

@@ -1,2 +1,4 @@
 mkdocs
 mkdocs-include-markdown-plugin
+mkdocstrings
+mkdocstrings-python

influxdb_client_3/write_client/client/write_api.py

@@ -296,9 +296,7 @@ def __init__(self,
 
         if self._write_options.write_type is WriteType.asynchronous:
             message = """The 'WriteType.asynchronous' is deprecated and will be removed in future major version.
-
-You can use native asynchronous version of the client:
-- https://influxdb-client.readthedocs.io/en/stable/usage.html#how-to-use-asyncio
+            You can use native asynchronous version of the client:
         """
             # TODO above message has link to Influxdb2 API __NOT__ Influxdb3 API !!! - illustrates different API
             warnings.warn(message, DeprecationWarning)