/*
 * Copyright 2021, TeamDev. All rights reserved.
 *
 * 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
 *
 * Redistribution and use in source and/or binary forms, with or without
 * modification, must retain the above copyright notice and the following
 * disclaimer.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

package io.spine.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Annotates a program element (class, method, package, etc.) which is internal to Spine and is
 * not a part of the public API, and thus should not be used by users of the framework.
 *
 * <p>If you plan to implement an extension of the framework, which is going to be
 * wired into the framework, you may use the internal parts. Consult with Spine
 * team, as the internal APIs do not have the same stability API guarantee as public ones.
 *
 * <p>See {@link SPI} annotation if you plan to write an extension of the framework.
 * @see SPI
 */
@Internal
@Retention(RetentionPolicy.SOURCE)
@Target({
        ElementType.ANNOTATION_TYPE,
        ElementType.CONSTRUCTOR,
        ElementType.FIELD,
        ElementType.METHOD,
        ElementType.PACKAGE,
        ElementType.TYPE})
@Documented
public @interface Internal {
}

@@ -1706,26 +1706,8 @@
 sion
- of the framework,
  whi
@@ -1723,19 +1723,16 @@
 ng to be
-%0A *
  wired i
@@ -1749,16 +1749,19 @@
 amework,
+%0A *
  you may
@@ -1761,16 +1761,24 @@
 you may 
+want to 
 use the 
@@ -1797,29 +1797,52 @@
 ts. 
-C
+Please consider c
 onsult
+ing
  with 
+the 
 Spine%0A *
  tea
@@ -1837,16 +1837,28 @@
 Spine%0A *
+ development
  team, a
@@ -1924,16 +1924,19 @@
 antee as
+%0A *
  public 
@@ -2029,16 +2029,19 @@
 mework.%0A
+ *%0A
  * @see 

Improve Javadoc text and layout