Add distributed API documentation

docs/sphinx/api.rst

@@ -59,6 +59,11 @@ a heading brings in the features listed under that heading.
 
    api/public_api.rst
 
+.. toctree::
+   :maxdepth: 1
+
+   api/public_distributed_api.rst
+
 .. toctree::
    :maxdepth: 1
 

docs/sphinx/api/public_distributed_api.rst

@@ -0,0 +1,95 @@
+..
+    Copyright (C) 2023 Dimitra Karatza
+
+    SPDX-License-Identifier: BSL-1.0
+    Distributed under the Boost Software License, Version 1.0. (See accompanying
+    file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+.. _public_distributed_api:
+
+======================
+Public distributed API
+======================
+
+Our Public Distributed API offers a rich set of tools and functions that enable developers
+to harness the full potential of distributed computing. Here, you'll find a comprehensive
+list of header files, classes and functions for various distributed computing features
+provided by |hpx|.
+
+.. _public_distr_api_header_all_gather:
+
+``hpx/collectives/all_gather.hpp``
+==================================
+
+The header :hpx-header:`libs/full/collectives/include,hpx/collectives/all_gather.hpp`
+contains definitions and implementations related to the `all_gather` operation.
+
+Functions
+---------
+
+.. table:: `hpx` functions of header ``hpx/collectives/all_gather.hpp``
+
+   +------------------------------------------+
+   | Function                                 |
+   +==========================================+
+   | :cpp:func:`hpx::collectives::all_gather` |
+   +------------------------------------------+
+
+.. _public_distr_api_header_all_reduce:
+
+``hpx/collectives/all_reduce.hpp``
+==================================
+
+The header :hpx-header:`libs/full/collectives/include,hpx/collectives/all_reduce.hpp`
+contains definitions and implementations related to the `all_reduce` operation.
+
+Functions
+---------
+
+.. table:: `hpx` functions of header ``hpx/collectives/all_reduce.hpp``
+
+   +------------------------------------------+
+   | Function                                 |
+   +==========================================+
+   | :cpp:func:`hpx::collectives::all_reduce` |
+   +------------------------------------------+
+
+.. _public_distr_api_header_all_to_all:
+
+``hpx/collectives/all_to_all.hpp``
+==================================
+
+The header :hpx-header:`libs/full/collectives/include,hpx/collectives/all_to_all.hpp`
+contains definitions and implementations related to the `all_to_all` operation.
+
+Functions
+---------
+
+.. table:: `hpx` functions of header ``hpx/collectives/all_to_all.hpp``
+
+   +------------------------------------------+
+   | Function                                 |
+   +==========================================+
+   | :cpp:func:`hpx::collectives::all_to_all` |
+   +------------------------------------------+
+
+.. _public_distr_api_header_argument_types:
+
+``hpx/collectives/argument_types.hpp``
+==================================
+
+The header :hpx-header:`libs/full/collectives/include,hpx/collectives/argument_types.hpp`
+contains definitions and implementations related to the `argument_types` operation.
+
+Functions
+---------
+
+.. table:: `hpx` functions of header ``hpx/collectives/argument_types.hpp``
+
+   +----------------------------------------------+
+   | Function                                     |
+   +==============================================+
+   | :cpp:class:`hpx::collectives::argument_type` |
+   +----------------------------------------------+
+   | :cpp:func:`hpx::collectives::argument_type`  |
+   +----------------------------------------------+