mik-laj commented on a change in pull request #10081:
URL: https://github.com/apache/airflow/pull/10081#discussion_r466598778
##########
File path: docs/howto/connection/index.rst
##########
@@ -88,6 +88,31 @@ Alternatively you may specify each parameter individually:
--conn-schema 'schema' \
...
+.. _connection/export:
+
+Exporting Connections from the CLI
+----------------------------------
+
+You may export connections from the database using the CLI. The supported
formats are ``json``, ``yaml`` and ``env``.
Review comment:
Can you describe exactly what each of these file formats looks like? It
is very important that the user can look into the documentation to know what
such a file looks like. Here is an example of a similar description so you can
copy common parts of your docs.
https://airflow.readthedocs.io/en/latest/howto/use-alternative-secrets-backend.html#local-filesystem-secrets-backend
At this point, it makes sense to add a reference to your section.
> You can create the file by exporting the connections from the database,
for more information see: "Exporting connection from the CLI"
Documentation is often the more difficult part than writing an
implementation, but I try to fill many gaps in the documentation.
----------------------------------------------------------------
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]
