wjones127 commented on code in PR #33660:
URL: https://github.com/apache/arrow/pull/33660#discussion_r1070137390


##########
.github/pull_request_template.md:
##########
@@ -57,5 +57,11 @@ If there are user-facing changes then we may require 
documentation to be updated
 -->
 
 <!--
-If there are any breaking changes to public APIs, please add the 
`breaking-change` label.
--->
\ No newline at end of file
+If there are any breaking changes to public APIs, please uncomment the 
following line:
+-->
+<!-- **This PR includes breaking changes to public APIs.** -->
+
+<!--
+If the changes fix either a security vulnerability or a bug that caused 
incorrect or invalid data to be produced. This is intended to mark changes that 
may affect users without their knowledge. For this reason, fixing bugs that 
cause errors or crashes don't count, since those are usually obvious.
+-->

Review Comment:
   > Also, do we want to carve out an exception for experimental APIs?
   
   And that's a good question on experimental APIs... I'm inclined to say it's 
still good to mark them as breaking changes. When we mark them as experimental, 
we are telling users to expect the API to change, but not that we won't warn 
them if they do 😄. That being said, in the future if we decide to do semantic 
versioning, we would probably treat breaking changes in experimental APIs 
differently from those in stable APIs.



-- 
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.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to