[AB-199] adding build of sources and javadoc

fixing javadoc as various places
adding release plugin
adding developer connection to scm
updating release pipeline to new action versions

abstracto-application/abstracto-modules/assignable-roles/assignable-roles-int/src/main/java/dev/sheldan/abstracto/assignableroles/service/AssignableRolePlaceService.java

@@ -213,6 +213,7 @@ public interface AssignableRolePlaceService {
      * @param server The {@link AServer server} in which the {@link AssignableRolePlace place} is
      * @param name The key of the {@link AssignableRolePlace place}
      * @param newValue The new vale of the inline attribute
+     * @return A {@link CompletableFuture future} which completes when the config has been updated, or when the message was edited (if the posts already exist)
      */
     CompletableFuture<Void> setAssignablePlaceInlineTo(AServer server, String name, Boolean newValue);
 
@@ -222,6 +223,7 @@ public interface AssignableRolePlaceService {
      * are any.
      * @param server The {@link AServer server} in which the {@link AssignableRolePlace place} is
      * @param name The key of the {@link AssignableRolePlace place} to inline
+     * @return A {@link CompletableFuture future} which completes when the config has been updated, or when the message was edited (if the posts already exist)
      */
     CompletableFuture<Void> inlineAssignableRolePlace(AServer server, String name);
 
@@ -229,6 +231,7 @@ public interface AssignableRolePlaceService {
      * Sets the inline attribute of the {@link AssignableRolePlace place} to true. This method will update any existing
      * {@link AssignableRolePlacePost posts} of the place, if there are any.
      * @param place The {@link AssignableRolePlace place} to inline
+     * @return A {@link CompletableFuture future} which completes when the config has been updated, or when the message was edited (if the posts already exist)
      */
     CompletableFuture<Void> inlineAssignableRolePlace(AssignableRolePlace place);
 
@@ -238,6 +241,7 @@ public interface AssignableRolePlaceService {
      * are any.
      * @param server The {@link AServer server} in which the {@link AssignableRolePlace place} is
      * @param name The key of the {@link AssignableRolePlace place} to spread
+     * @return A {@link CompletableFuture future} which completes when the config has been updated, or when the message was edited (if the posts already exist)
      */
     CompletableFuture<Void> spreadAssignableRolePlace(AServer server, String name);
 
@@ -245,6 +249,7 @@ public interface AssignableRolePlaceService {
      * Sets the inline attribute of the {@link AssignableRolePlace place} to false. This method will update any existing
      * {@link AssignableRolePlacePost posts} of the place, if there are any.
      * @param place The {@link AssignableRolePlace place} to spread
+     * @return A {@link CompletableFuture future} which completes when the config has been updated, or when the message was edited (if the posts already exist)
      */
     CompletableFuture<Void> spreadAssignableRolePlace(AssignableRolePlace place);
 
@@ -389,6 +394,7 @@ public interface AssignableRolePlaceService {
      * @param server The {@link AServer server} in which the {@link AssignableRolePlace place} is
      * @param name The key of the {@link AssignableRolePlace place}
      * @param newText The new value for the text attribute displayed in the first {@link AssignableRolePlacePost post}
+     * @return A {@link CompletableFuture future} which completes when the config has been updated, or when the message was edited (if the posts already exist)
      */
     CompletableFuture<Void> changeTextAsync(AServer server, String name, String newText);
 

abstracto-application/abstracto-modules/assignable-roles/assignable-roles-int/src/main/java/dev/sheldan/abstracto/assignableroles/service/management/AssignableRoleManagementService.java

@@ -59,9 +59,9 @@ public interface AssignableRoleManagementService {
     /**
      * Returns the respective {@link AssignableRole assignableRole} for the {@link CachedEmote emote} which is part of the
      * {@link AssignableRolePlace place}. It will throw an exception, if the {@link CachedEmote emote} is not used.
-     * @param cachedEmote
-     * @param assignableRolePlace
-     * @return
+     * @param cachedEmote The {@link CachedEmote emote} which should be used to identify the {@link AssignableRole role}
+     * @param assignableRolePlace The {@link AssignableRolePlace place} from which the {@link AssignableRole role} should be retrieved for
+     * @return An instance of {@link AssignableRole role} which was in the place and identified by the emote
      */
     AssignableRole getRoleForReactionEmote(CachedEmote cachedEmote, AssignableRolePlace assignableRolePlace);
 }

abstracto-application/abstracto-modules/assignable-roles/assignable-roles-int/src/main/java/dev/sheldan/abstracto/assignableroles/service/management/AssignableRolePlacePostManagementService.java

@@ -31,7 +31,7 @@ public interface AssignableRolePlacePostManagementService {
      * Creates an {@link AssignableRolePlacePost post} for the given {@link AssignableRolePlace place} in the given message ID
      * @param updatedPlace The {@link AssignableRolePlace place} this post should be part of
      * @param messageId The ID of the message in which the post exists
-     * @return
+     * @return The {@link AssignableRolePlacePost post} which is found in the given {@link AssignableRolePlace place} of the {@link net.dv8tion.jda.api.entities.Message message} ID
      */
     AssignableRolePlacePost createAssignableRolePlacePost(AssignableRolePlace updatedPlace, Long messageId);
 }