mik-laj commented on a change in pull request #9549:
URL: https://github.com/apache/airflow/pull/9549#discussion_r448789877
##########
File path: docs/howto/use-alternative-secrets-backend.rst
##########
@@ -92,8 +92,13 @@ file ``/files/my_conn.json`` when it looks for connections.
The file can be defined in ``JSON``, ``YAML`` or ``env`` format.
+Any extra json parameters can be provided using keys like ``extra_dejson`` and
``extra``.
+The key ``extra_dejson`` can be used to provide parameters as JSON object
where as the key ``extra`` can be used in case of a JSON string.
+The keys ``extra`` and ``extra_dejson`` are mutually exclusive.
+
The JSON file must contain an object where the key contains the connection ID
and the value contains
the definitions of one or more connections. The connection can be defined as a
URI (string) or JSON object.
+
For a guide about defining a connection as a URI, see::
:ref:`generating_connection_uri`.
For a description of the connection object parameters see
:class:`~airflow.models.connection.Connection`.
The following is a sample JSON file.
Review comment:
You can move this sentence for introduction. We have the first use of
this concept there, so these links should be earlier.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
