src/jdk.management/share/classes/com/sun/management/HotSpotDiagnosticMXBean.java

*** 114,10 ***
--- 114,17 ---
      /**
       * Generate a thread dump to the given file in the given format. The
       * {@code outputFile} parameter must be an absolute path to a file that
       * does not exist.
       *
+      * <p> When the format is specified as {@link ThreadDumpFormat#JSON JSON}, the
+      * thread dump is generated in JavaScript Object Notation.
+      * <a href="doc-files/threadDump.schema.json">threadDump.schema.json</a>
+      * describes the thread dump format in draft
+      * <a href="https://tools.ietf.org/html/draft-json-schema-language-02">
+      * JSON Schema Language version 2</a>.
+      *
       * <p> The thread dump will include output for all platform threads. It may
       * include output for some or all virtual threads.
       *
       * @implSpec
       * The default implementation throws {@code UnsupportedOperationException}.

*** 149,9 ***
--- 156,10 ---
           * Plain text format.
           */
          TEXT_PLAIN,
          /**
           * JSON (JavaScript Object Notation) format.
+          * @spec https://datatracker.ietf.org/doc/html/rfc8259 JavaScript Object Notation
           */
          JSON,
      }
  }