<commit_before>/**
 * (c) Copyright 2012 WibiData, Inc.
 *
 * See the NOTICE file distributed with this work for additional
 * information regarding copyright ownership.
 *
 * Licensed 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.kiji.annotations;

import java.lang.annotation.Documented;

/**
 * Annotations that inform users of a package, class or method's current stability
 * level. The stability level may be {@link Stable}, {@link Evolving}, or {@link Unstable}.
 *
 * <ul>
 *   <li>By default, unlabeled classes should be assumed to be unstable.</li>
 *   <li>{@link Stable} APIs are guaranteed to change only in binary-compatible
 *     ways within a major version (e.g., all 1.x.x versions)</li>
 *   <li>{@link Evolving} APIs may change in binary-incompatible ways between
 *     minor versions (e.g., from 1.4.1 to 1.5.0) of the software.</li>
 *   <li>{@link Unstable} APIs may change at any time.</li>
 * </ul>
 *
 * <p>{@link Private} APIs should all be considered {@link Unstable}.</p>
 */
@ApiAudience.Framework
@ApiStability.Evolving
public final class ApiStability {

  /** This class cannot be constructed. */
  private ApiStability() { }


  /** An API that does not change in incompatible ways within a major version. */
  @Documented public @interface Stable { }

  /** An API that does not change in incompatible ways within a minor version. */
  @Documented public @interface Evolving { }

  /** An API that may change at any time. */
  @Documented public @interface Unstable { }
}<commit_msg>Adds ApiStability.Experimental.<commit_after>/**
 * (c) Copyright 2012 WibiData, Inc.
 *
 * See the NOTICE file distributed with this work for additional
 * information regarding copyright ownership.
 *
 * Licensed 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.kiji.annotations;

import java.lang.annotation.Documented;

/**
 * Annotations that inform users of a package, class or method's current stability
 * level. The stability level may be {@link Stable}, {@link Evolving}, or {@link Unstable}.
 *
 * <ul>
 *   <li>By default, unlabeled classes should be assumed to be Experimental.</li>
 *   <li>{@link Stable} APIs are guaranteed to change only in binary-compatible
 *     ways within a major version (e.g., all 1.x.x versions)</li>
 *   <li>{@link Evolving} APIs may change in binary-incompatible ways between
 *     minor versions (e.g., from 1.4.1 to 1.5.0) of the software. In
 *     particular, new features may be added in one minor version and altered
 *     or removed in the next.</li>
 *   <li>{@link Experimental} APIs may change at any time.</li>
 *   <li>{@link Unstable} This annotation is no longer used. New code should
 *     use Experimental instead.</li>
 * </ul>
 *
 * <p>{@link Private} APIs should all be considered {@link Unstable}.</p>
 */
@ApiAudience.Framework
@ApiStability.Evolving
public final class ApiStability {

  /** This class cannot be constructed. */
  private ApiStability() { }


  /** An API that does not change in incompatible ways within a major version. */
  @Documented public @interface Stable { }

  /** An API that does not change in incompatible ways within a minor version. */
  @Documented public @interface Evolving { }

  /** An API that may change at any time. */
  @Documented public @interface Experimental { }

  /** This annotation is deprecated and {@link Experimental} should be used instead. */
  @Documented @Deprecated public @interface Unstable { }
}
{'fraction_non_alphanumeric': 0.0998432952764719, 'fraction_numerical': 0.006715916722632639, 'mean_word_length': 3.6252587991718426, 'pattern_counts': {'":': 0, '<': 29, '<?xml version=': 0, '>': 29, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3396698', 'n_tokens_mistral': 1238, 'n_tokens_neox': 1188, 'n_words': 557}