[GitHub] [airflow] mik-laj commented on a change in pull request #10099: More user-oriented change titles in Python API sections

[GitBox <gi...@apache.org>]

mik-laj commented on a change in pull request #10099:
URL: https://github.com/apache/airflow/pull/10099#discussion_r463999696



##########
File path: UPDATING.md
##########
@@ -1374,78 +1407,70 @@ of this provider.
 This section describes the changes that have been made, and what you need to do to update your if
 you use any code located in `airflow.providers` package.
 
-#### Changes to SalesforceHook
+#### Removed Hipchat integration
+
+Hipchat has reached end of life and is no longer available.
+
+For more information please see
+https://community.atlassian.com/t5/Stride-articles/Stride-and-Hipchat-Cloud-have-reached-End-of-Life-updated/ba-p/940248
+
+#### `airflow.providers.salesforce.hooks.salesforce.SalesforceHook`
 
-Replace parameter ``sandbox`` with ``domain``. According to change in simple-salesforce package
+Replace parameter ``sandbox`` with ``domain``. According to change in simple-salesforce package.
 
-#### Rename parameter name in PinotAdminHook.create_segment
+Rename `sign_in` function to `get_conn`.
+
+#### `airflow.providers.apache.pinot.hooks.pinot.PinotAdminHook.create_segment`
 
 Rename parameter name from ``format`` to ``segment_format`` in PinotAdminHook function create_segment fro pylint compatible
 
-#### Rename parameter name in HiveMetastoreHook.get_partitions
+#### `airflow.providers.apache.hive.hooks.hive.HiveMetastoreHook.get_partitions`
 
 Rename parameter name from ``filter`` to ``partition_filter`` in HiveMetastoreHook function get_partitions for pylint compatible
 
-#### Remove unnecessary parameter in FTPHook.list_directory
+#### `airflow.providers.ftp.hooks.ftp.FTPHook.list_directory`
 
-Remove unnecessary parameter ``nlst`` in FTPHook function list_directory for pylint compatible
+Remove unnecessary parameter ``nlst`` in FTPHook function ``list_directory`` for pylint compatible
 
-#### Remove unnecessary parameter in PostgresHook function copy_expert
+#### `airflow.providers.postgres.hooks.postgres.PostgresHook.copy_expert`
 
-Remove unnecessary parameter ``open`` in PostgresHook function copy_expert for pylint compatible
+Remove unnecessary parameter ``open`` in PostgresHook function ``copy_expert`` for pylint compatible
 
-#### Change parameter name in OpsgenieAlertOperator
+#### `airflow.providers.opsgenie.operators.opsgenie_alert.OpsgenieAlertOperator`
 
 Change parameter name from ``visibleTo`` to ``visible_to`` in OpsgenieAlertOperator for pylint compatible
 
-#### Changes to ImapHook, ImapAttachmentSensor and ImapAttachmentToS3Operator
+#### `airflow.providers.imap.hooks.imap.ImapHook`
+#### `airflow.providers.imap.sensors.imap_attachment.ImapAttachmentSensor`
 
 ImapHook:
 * The order of arguments has changed for `has_mail_attachment`,
 `retrieve_mail_attachments` and `download_mail_attachments`.
 * A new `mail_filter` argument has been added to each of those.
 
-ImapAttachmentSensor:

Review comment:
       It's not breaking-change. Operators must use keywords arguments.




----------------------------------------------------------------
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:
users@infra.apache.org