Replace apiargs for functions

Author: jmikola

docs/includes/apiargs-function-add_logger-param.yaml

@@ -23,9 +23,24 @@ Definition
 
       function add_logger(Psr\Log\LoggerInterface $logger): void
 
-   This method has the following parameters:
+Parameters
+----------
+
+This function has the following parameters:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 80
+
+   * - Name
+     - Type
+     - Description
+
+   * - $logger
+     - Psr\\Log\\LoggerInterface
+     - A logger to register.
 
-   .. include:: /includes/apiargs/function-add_logger-param.rst
+       If the logger is already registered, the method will have no effect.
 
 Behavior
 --------

docs/includes/apiargs-function-remove_logger-param.yaml

@@ -23,9 +23,24 @@ Definition
 
       function remove_logger(Psr\Log\LoggerInterface $logger): void
 
-   This method has the following parameters:
+Parameters
+----------
+
+This function has the following parameters:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 80
+
+   * - Name
+     - Type
+     - Description
+
+   * - $logger
+     - Psr\\Log\\LoggerInterface
+     - A logger to unregister.
 
-   .. include:: /includes/apiargs/function-remove_logger-param.rst
+       If the logger is not registered, the method will have no effect.
 
 Errors/Exceptions
 -----------------

docs/includes/apiargs-function-with_transaction-param.yaml

@@ -23,9 +23,34 @@ Definition
 
       function with_transaction(MongoDB\Driver\Session $session, callable $callback, array $transactionOptions = []): void
 
-   This method has the following parameters:
+Parameters
+----------
+
+This function has the following parameters:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 80
+
+   * - Name
+     - Type
+     - Description
+
+   * - $session
+     - :php:`MongoDB\\Driver\\Session <mongodb-driver-session>`
+     - A client session used to execute the transaction.
+
+   * - $callback
+     - :php:`callable <language.types.callable>`
+     - A callback that will be run inside the transaction. The callback must
+       accept a :php:`MongoDB\\Driver\\Session <mongodb-driver-session>` object
+       as first argument.
 
-   .. include:: /includes/apiargs/function-with_transaction-param.rst
+   * - $transactionOptions
+     - array
+     - Transaction options, which will be passed to
+       :php:`MongoDB\\Driver\\Session::startTransaction <mongodb-driver-session.starttransaction>`.
+       See the extension documentation for a list of supported options.
 
 Behavior
 --------