cleanup and document some API classes

src/api/java/com/github/minecraftschurlimods/bibliocraft/api/BibliocraftApi.java

@@ -10,24 +10,35 @@
 import java.util.ServiceLoader;
 import java.util.function.Supplier;
 
+/**
+ * The main accessor class for Bibliocraft's API. Use this to get references to the singleton instances of {@link BibliocraftWoodTypeRegistry} and {@link BibliocraftDatagenHelper}.
+ */
 @ApiStatus.NonExtendable
 public interface BibliocraftApi {
     String MOD_ID = "bibliocraft";
 
+    /**
+     * @return The only instance of {@link BibliocraftDatagenHelper}.
+     */
     static BibliocraftDatagenHelper getDatagenHelper() {
         return InstanceHolder.DATAGEN_HELPER.get();
     }
 
+    /**
+     * @return The only instance of {@link BibliocraftWoodTypeRegistry}.
+     */
     static BibliocraftWoodTypeRegistry getWoodTypeRegistry() {
         return InstanceHolder.WOOD_TYPE_REGISTRY.get();
     }
 
+    /**
+     * The internal class used to hold the instances. DO NOT ACCESS YOURSELF!
+     */
     @ApiStatus.Internal
     final class InstanceHolder {
-        private InstanceHolder() {}
-
         private static final Lazy<BibliocraftDatagenHelper> DATAGEN_HELPER = Lazy.concurrentOf(fromServiceLoader(BibliocraftDatagenHelper.class));
         private static final Lazy<BibliocraftWoodTypeRegistry> WOOD_TYPE_REGISTRY = Lazy.concurrentOf(fromServiceLoader(BibliocraftWoodTypeRegistry.class));
+        private InstanceHolder() {}
 
         private static <T> Supplier<T> fromServiceLoader(Class<T> clazz) {
             return () -> {

src/api/java/com/github/minecraftschurlimods/bibliocraft/api/BibliocraftWoodType.java

@@ -7,6 +7,15 @@
 
 import java.util.function.Supplier;
 
+/**
+ * Holds all information Bibliocraft needs about a wood type.
+ *
+ * @param id The id of the wood type.
+ * @param woodType   The corresponding vanilla {@link WoodType}.
+ * @param properties A supplier for the wood type's {@link BlockBehaviour.Properties}.
+ * @param texture    The location of the wood type's plank texture. Used in datagen.
+ * @param family     The corresponding {@link BlockFamily}. Used in datagen.
+ */
 public record BibliocraftWoodType(
         ResourceLocation id,
         WoodType woodType,

src/api/java/com/github/minecraftschurlimods/bibliocraft/api/BibliocraftWoodTypeRegistry.java

@@ -11,7 +11,6 @@
  * Make sure to put this call behind a {@code ModList.isLoaded("bibliocraft")} check, and in a separate class, to prevent accidental classloading (like you would with client classes).
  */
 public interface BibliocraftWoodTypeRegistry {
-
     /**
      * @param id The id of the wood type to get.
      * @return The wood type with the given id. May return null if no wood type with the given id exists.

src/api/java/com/github/minecraftschurlimods/bibliocraft/api/RegisterBibliocraftWoodTypesEvent.java

@@ -11,6 +11,12 @@
 import java.util.Map;
 import java.util.function.Supplier;
 
+/**
+ * Register your own {@link BibliocraftWoodType}s here.
+ *
+ * This event is not cancelable. This event is fired on the {@link net.neoforged.fml.common.Mod.EventBusSubscriber.Bus.MOD}.
+ */
+@SuppressWarnings({"JavadocBlankLines", "JavadocReference"})
 public class RegisterBibliocraftWoodTypesEvent extends Event implements IModBusEvent {
     private final Map<ResourceLocation, BibliocraftWoodType> woodTypes;