refactor: add annotations and organize main tests

Author: Ivan-Montes

core/src/main/java/com/linecorp/armeria/server/docs/DocServiceBuilder.java

@@ -558,9 +558,10 @@ private static String[] guessAndSerializeExampleRequest(Object exampleRequest) {
 
     /**
      * Sets the title of the web application to be used in the documentation service.
-     * @param webAppTitle  * The title cannot be null, empty, or exceed a maximum length of 50 characters.
+     * @param webAppTitle  The title cannot be null, empty, or exceed a maximum length of 50 characters.
      * @return The current {@link DocServiceBuilder} instance for method chaining.
      */
+    @UnstableApi
     public DocServiceBuilder webAppTitle(String webAppTitle) {
         requireNonNull(webAppTitle, WEB_APP_TITLE_KEY);
         checkArgument(!webAppTitle.trim().isEmpty(), "%s is empty.", WEB_APP_TITLE_KEY);

core/src/main/java/com/linecorp/armeria/server/docs/DocServiceInjectableScripts.java

@@ -20,9 +20,12 @@
 
 import java.util.regex.Pattern;
 
+import com.linecorp.armeria.common.annotation.UnstableApi;
+
 /**
  * Provides utilities for {@link DocServiceBuilder#injectedScripts(String...)}.
  */
+@UnstableApi
 public final class DocServiceInjectableScripts {
 
     private static final String HEX_COLOR_PATTERN = "^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$";

core/src/test/java/com/linecorp/armeria/server/docs/DocServiceInjectableScriptsTest.java

@@ -40,7 +40,7 @@ void titleBackground_givenValidColor_returnsScriptWithColor(String color) {
     @ValueSource(strings = { "#1234567", "#ABCDEFA", "#7654321"})
     void titleBackground_givenTooLongColor_throwsException(String color) {
 
-        assertThatThrownBy(() -> DocServiceInjectableScripts.gotoBackground(color))
+        assertThatThrownBy(() -> DocServiceInjectableScripts.titleBackground(color))
                 .isInstanceOf(IllegalArgumentException.class)
                 .hasMessageContaining("length exceeds");
     }
@@ -49,7 +49,7 @@ void titleBackground_givenTooLongColor_throwsException(String color) {
     @ValueSource(strings = { "#12345Z", "#ZABCDE", "#@12345"})
     void titleBackground_givenInvalidColor_throwsException(String color) {
 
-        assertThatThrownBy(() -> DocServiceInjectableScripts.gotoBackground(color))
+        assertThatThrownBy(() -> DocServiceInjectableScripts.titleBackground(color))
                 .isInstanceOf(IllegalArgumentException.class)
                 .hasMessageContaining("not in hex format");
     }