feat: ConfiguredProperty for documenting "magic" values consistently

config-specs/properties/properties.json

@@ -0,0 +1,4 @@
+{
+  "MIN_VELOCITY_JAVA": "17",
+  "RECOMMENDED_PAPER_JAVA": "21"
+}

docs/paper/admin/getting-started/getting-started.md → docs/paper/admin/getting-started/getting-started.mdx

@@ -13,12 +13,12 @@ With the release of Minecraft 1.18, Paper now requires **Java 17** to run. We re
 
 :::
 
-| Paper Version  | Recommended Java Version |
-|----------------|--------------------------|
-| 1.8 to 1.11    | Java 8                   |
-| 1.12 to 1.16.4 | Java 11                  |
-| 1.16.5         | Java 16                  |
-| 1.17.1-1.18.1+ | Java 21                  |
+| Paper Version  | Recommended Java Version                                         |
+|----------------|------------------------------------------------------------------|
+| 1.8 to 1.11    | Java 8                                                           |
+| 1.12 to 1.16.4 | Java 11                                                          |
+| 1.16.5         | Java 16                                                          |
+| 1.17.1-1.18.1+ | Java <ConfiguredProperty propertyKey="RECOMMENDED_PAPER_JAVA" /> |
 
 ## Downloading Paper
 

docs/velocity/admin/getting-started/README.md → docs/velocity/admin/getting-started/README.mdx

@@ -9,7 +9,7 @@ This page covers how to install and set up a minimal configuration of Velocity.
 ## Installing Java
 
 Velocity is written in Java, so if you do not already have Java installed, you will need to install
-it before you continue. Velocity requires Java 17 or newer. See our
+it before you continue. Velocity requires Java <ConfiguredProperty propertyKey="MIN_VELOCITY_JAVA" /> or newer. See our
 [java installation guide](/misc/java-install) for detailed instructions.
 
 ## Downloading Velocity

docs/velocity/admin/getting-started/faq.md → docs/velocity/admin/getting-started/faq.mdx

@@ -10,7 +10,7 @@ many of these questions from the user perspective.
 
 ## What version of Java does Velocity require?
 
-Velocity 3.3.x requires Java 17 or above.
+Velocity 3.3.x requires Java <ConfiguredProperty propertyKey="MIN_VELOCITY_JAVA" /> or above.
 
 ## Where can I find Velocity plugins?
 

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

@@ -26,7 +26,7 @@ IDEA is recommended.
 - Open your IDE
 - Click `Create New Project` or the equivalent
 - Select either `Gradle` or `Maven`
-- Make sure your **Project JDK** is Java 11 or later
+- Make sure your **Project JDK** is Java <ConfiguredProperty propertyKey="MIN_VELOCITY_JAVA" /> or later
 - **Finish** the dialog and open the project.
 
 Now we have created our project, we need configure our build system.
@@ -174,7 +174,7 @@ You will be asked to provide some information about your project.
 | **Group ID**         | The group ID of your project. This is used for Maven and Gradle. This is usually your domain name in reverse. If you don't know what you should put here, you can use something like `io.github.<yourname>` or if you don't have GitHub you can just use `me.<yourname>`. |
 | **Artifact ID**      | The artifact ID of your project. This is used for Maven and Gradle. This is usually the name of your project. This is usually the same as the `Name` field.                                                                                                               |
 | **Version**          | The version of your project. This is used for Maven and Gradle. This is usually `1.0-SNAPSHOT` and does not really matter for now.                                                                                                                                        |
-| **JDK**              | The JDK you want to use. This can be anything from Java 11 and above.                                                                                                                                                                                                     |
+| **JDK**              | The JDK you want to use. This can be anything from Java <ConfiguredProperty propertyKey="MIN_VELOCITY_JAVA" /> and above.                                                                                                                                                                                                     |
 
 Now you can click on the `Create` button and IntelliJ will create the project for you.
 If everything went well, you should see something like this:

docs/velocity/dev/how-to/porting-from-velocity-1.md → docs/velocity/dev/how-to/porting-from-velocity-1.mdx

@@ -10,7 +10,7 @@ document very carefully**.
 
 ## Minimum supported Java version bump
 
-Velocity 3.3.x now requires Java 17 and above.
+Velocity 3.3.x now requires Java <ConfiguredProperty propertyKey="MIN_VELOCITY_JAVA" /> and above.
 
 ## Removal of legacy dependencies
 

src/components/ConfiguredProperty.tsx

@@ -0,0 +1,27 @@
+import React from 'react';
+import configuredProperties from '@site/config-specs/properties/properties.json';
+
+const CONFIGURED_PROPERTY_NAMES = Object.keys(configuredProperties);
+
+export function isConfiguredProperty(propertyKey: string): boolean {
+    return CONFIGURED_PROPERTY_NAMES.includes(propertyKey);
+}
+
+export function getConfiguredProperty(propertyKey: string): string {
+    return configuredProperties[propertyKey];
+}
+
+export default function ConfiguredProperty({ propertyKey }) {
+
+    if (!isConfiguredProperty(propertyKey)) {
+        return null;
+    }
+
+    const value = getConfiguredProperty(propertyKey);
+
+    return (
+        <span className="configured-property">
+            {value}
+        </span>
+    );
+}

src/theme/MDXComponents.tsx

@@ -1,11 +1,12 @@
 import React from 'react';
 import { Icon } from '@iconify/react';
 import MDXComponents from '@theme-original/MDXComponents';
-import TabItem from "@theme/TabItem";
-import Tabs from "@theme/Tabs";
-import VersionFormattedCode from '../components/VersionFormattedCode';
-import SoftwareVersion from "../components/SoftwareVersion";
-import VersionedJavaDocLink from "../components/VersionedJavaDocLink";
+import TabItem from '@theme/TabItem';
+import Tabs from '@theme/Tabs';
+import VersionFormattedCode from '@site/src/components/VersionFormattedCode';
+import SoftwareVersion from '@site/src/components/SoftwareVersion';
+import VersionedJavaDocLink from '../components/VersionedJavaDocLink';
+import ConfiguredProperty from '@site/src/components/ConfiguredProperty';
 
 export default {
     // Re-use the default mapping
@@ -16,5 +17,6 @@ export default {
     VersionFormattedCode,
     SoftwareVersion,
     VersionedJavaDocLink,
+    ConfiguredProperty,
     Icon: Icon,
 };