Github user vanzin commented on a diff in the pull request:
https://github.com/apache/spark/pull/15374#discussion_r82433404
--- Diff:
common/tags/src/main/java/org/apache/spark/annotation/InterfaceStability.java
---
@@ -0,0 +1,49 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.spark.annotation;
+
+import java.lang.annotation.Documented;
+
+/**
+ * Annotation to inform users of how much to rely on a particular package,
+ * class or method not changing over time.
+ */
+public class InterfaceStability {
+
+ /**
+ * Stable APIs that retain source and binary compatibility within a
major release.
+ * These interfaces can change from one major release to another major
release
+ * (e.g. from 1.0 to 2.0).
+ */
+ @Documented
+ public @interface Stable {};
+
+ /**
+ * APIs that are meant to evolve towards becoming stable APIs, but are
not stable APIs yet.
+ * Evolving interfaces can change from one feature release to another
release (i.e. 2.1 to 2.2).
+ */
+ @Documented
+ public @interface Evolving {};
--- End diff --
In my view "Evolving" would mean "this is sort of what the API will look
like, there might be some adjustments in the next release, so you have to be
willing to rev your code when the next release comes out".
"Unstable" means "user at your own risk, API may even not really work, and
can be deleted without notice".
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
