fix: use major minor version for Velocity Javadoc (#393)

Author: zlataovce

docs/velocity/dev/api/event.mdx

@@ -8,7 +8,7 @@ description: How to listen for events in Velocity.
 Listening to events with Velocity's `@Subscribe`
 annotation is straightforward. You've already seen one such listener, using
 <Javadoc name={"com.velocitypowered.api.event.proxy.ProxyInitializeEvent"} project={"velocity"}>`ProxyInitializeEvent`</Javadoc>
-in your main class. Additional events can be found on the [Javadoc](https://jd.papermc.io/velocity/3.0.0/).
+in your main class. Additional events can be found on the <Javadoc project={"velocity"}>Javadoc</Javadoc>.
 
 ## Creating a listener method
 

docs/velocity/dev/getting-started/creating-your-first-plugin.mdx

@@ -47,7 +47,7 @@ Now we have created our project, we need configure our build system.
 
 ### Javadocs
 
-Javadocs are available at [jd.papermc.io/velocity/3.0.0](https://jd.papermc.io/velocity/3.0.0).
+Javadocs are available at <Javadoc project={"velocity"}>jd.papermc.io</Javadoc>.
 
 ## Set up your build system
 

src/components/config/ConfigDocBlock.tsx

@@ -1,4 +1,4 @@
-import React, {useState, useEffect, useRef, ReactNode} from "react";
+import React, { useState, useEffect, useRef, ReactNode } from "react";
 import ReactMarkdown from "react-markdown";
 import style from "@site/src/css/markdown-styles.module.css";
 import yaml from "js-yaml";
@@ -8,11 +8,11 @@ import useBrokenLinks from "@docusaurus/core/lib/client/exports/useBrokenLinks";
 import Admonition from "@theme/Admonition";
 import clsx from "clsx";
 
-const createUrlHash = (parent: string | number, name: any) : string => {
+const createUrlHash = (parent: string | number, name: any): string => {
   return parent + (parent ? "_" : "") + parseUrlHash(name);
 };
 
-const parseUrlHash = (name: string) : string => {
+const parseUrlHash = (name: string): string => {
   return name.replace(/-/g, "_");
 };
 
@@ -48,14 +48,21 @@ const copyAndScroll = (parentKey: string, name: string): void => {
     console.error("Failed to copy to clipboard: ", error);
   });
   scrollIntoView(hash);
-}
+};
 
-const parseDefault = (value: string, collapse: boolean, parentKey: string, name: string, handleHashLinkClick, separator: string) : ReactNode => {
+const parseDefault = (
+  value: string,
+  collapse: boolean,
+  parentKey: string,
+  name: string,
+  handleHashLinkClick,
+  separator: string
+): ReactNode => {
   const hash = createUrlHash(parentKey, name);
   useBrokenLinks().collectAnchor(hash);
 
   if (value[0] === "[" && value[value.length - 1] === "]") {
-    const items : (string | ReactNode)[]  = value
+    const items: (string | ReactNode)[] = value
       .replace("[", "")
       .replace("]", "")
       .split(",")
@@ -100,7 +107,7 @@ const parseDefault = (value: string, collapse: boolean, parentKey: string, name:
   );
 };
 
-const parseItalics = (key : string) => {
+const parseItalics = (key: string) => {
   if (key.startsWith("<") && key.endsWith(">")) {
     return (
       <>
@@ -116,14 +123,14 @@ const parseDescriptionForVersioning = (description: String) => {
 };
 
 const YamlNodeWithDescription = ({
-                                   name,
-                                   node,
-                                   parentKey,
-                                   root,
-                                   separator,
-                                   showAllDescriptions,
-                                   defaultValue,
-                                 }) => {
+  name,
+  node,
+  parentKey,
+  root,
+  separator,
+  showAllDescriptions,
+  defaultValue,
+}) => {
   const ignoreInitialRenderRef = useRef(false);
   const [showDescription, setShowDescription] = useState(showAllDescriptions);
 
@@ -204,15 +211,15 @@ const YamlNodeWithDescription = ({
 };
 
 const YamlTreeNode = ({
-                        root,
-                        name,
-                        parentKey,
-                        value,
-                        separator,
-                        showAllDescriptions,
-                        defaultValue,
-                        warning,
-                      }) : ReactNode => {
+  root,
+  name,
+  parentKey,
+  value,
+  separator,
+  showAllDescriptions,
+  defaultValue,
+  warning,
+}): ReactNode => {
   if (name === "inline-docs-warning") return null;
 
   const handleClick = (event) => {
@@ -280,7 +287,7 @@ const renderYamlData = (
   separator: string,
   showAllDescriptions: boolean,
   defaultValue: string
-) : ReactNode => {
+): ReactNode => {
   const renderedNodes: JSX.Element[] = [];
 
   for (const [key, value] of Object.entries(data)) {
@@ -323,11 +330,11 @@ const renderYamlData = (
 };
 
 export default function Config({
-                                 data,
-                                 separator = ": ",
-                                 showDescriptions = false,
-                                 defaultValue = "N/A",
-                               }) : ReactNode {
+  data,
+  separator = ": ",
+  showDescriptions = false,
+  defaultValue = "N/A",
+}): ReactNode {
   const [showAllDescriptions, setShowAllExpanded] = useState(showDescriptions);
   let ymlData = yaml.load(data);
   return (

src/components/versioning/Javadoc.tsx

@@ -26,7 +26,7 @@ const createProjectTarget = (
 
 const targets: { [project: string]: TargetResolver } = {
   paper: createProjectTarget("paper"),
-  velocity: createProjectTarget("velocity", VersionType.MajorZeroed),
+  velocity: createProjectTarget("velocity", VersionType.MajorMinorZeroed),
   java: async (_, module) => {
     const version = getProperty("DOCS_JAVA") ?? "21";
 
@@ -51,7 +51,7 @@ export default function Javadoc({ name, module, project = "paper", children }: J
       if (resolve) {
         const target = await resolve(versionMeta, module);
 
-        setHref(`${target}/${formatName(name)}`);
+        setHref(name ? `${target}/${formatName(name)}` : target);
       }
     })();
   }, [name]);
@@ -60,7 +60,7 @@ export default function Javadoc({ name, module, project = "paper", children }: J
 }
 
 interface JavadocProps {
-  name: string;
+  name?: string;
   module?: string;
   project?: Project | "java";
   children: any;