hboutemy commented on code in PR #12635:
URL: https://github.com/apache/maven/pull/12635#discussion_r3686340286


##########
src/site/site.xml:
##########
@@ -43,26 +43,29 @@ under the License.
     </menu>
 
     <menu inherit="bottom" name="Descriptors Reference">
-      <item name="POM" href="./api/maven-api-model/maven.html"/>
-      <item name="Settings" href="./api/maven-api-settings/settings.html"/>
-      <item name="Toolchains" 
href="./api/maven-api-toolchain/toolchains.html"/>
-      <item name="Core Extensions" 
href="./api/maven-api-cli/core-extensions.html"/>
-      <item name="Repository Metadata" 
href="./api/maven-api-metadata/repository-metadata.html"/>
-      <item name="Plugin Descriptor" 
href="./api/maven-api-plugin/plugin.html"/>
-      <item name="Lifecycle Descriptor" 
href="./api/maven-api-plugin/lifecycle.html"/>
+    <!-- API documentation must be built separately with javadoc:javadoc -->
+      <!--item name="POM" href="./api/maven-api-model/maven.html"/-->
+      <!--item name="Settings" 
href="./api/maven-api-settings/settings.html"/-->
+      <!--item name="Toolchains" 
href="./api/maven-api-toolchain/toolchains.html"/-->
+      <!--item name="Core Extensions" 
href="./api/maven-api-cli/core-extensions.html"/-->
+      <!--item name="Repository Metadata" 
href="./api/maven-api-metadata/repository-metadata.html"/-->
+      <!--item name="Plugin Descriptor" 
href="./api/maven-api-plugin/plugin.html"/-->
+      <!--item name="Lifecycle Descriptor" 
href="./api/maven-api-plugin/lifecycle.html"/-->
     </menu>
 
     <menu inherit="bottom" name="Reference">
-      <item name="Lifecycles" href="./impl/maven-core/lifecycles.html"/>
-      <item name="Plugin Bindings to Default Lifecycle" 
href="./impl/maven-core/default-bindings.html"/>
-      <item name="Artifact Handlers" 
href="./impl/maven-core/artifact-handlers.html"/>
-      <item name="CLI options" href="./compat/maven-embedder/cli.html"/>
-      <item name="Super POM" 
href="./compat/maven-model-builder/super-pom.html"/>
+    <!-- Implementation modules documentation must be built separately -->
+      <!--item name="Lifecycles" href="./impl/maven-core/lifecycles.html"/-->
+      <!--item name="Plugin Bindings to Default Lifecycle" 
href="./impl/maven-core/default-bindings.html"/-->
+      <!--item name="Artifact Handlers" 
href="./impl/maven-core/artifact-handlers.html"/-->
+      <!--item name="CLI options" href="./compat/maven-embedder/cli.html"/-->
+      <!--item name="Super POM" 
href="./compat/maven-model-builder/super-pom.html"/-->
     </menu>
 
     <menu inherit="bottom" name="Development">
-      <item name="Maven Developer Centre" href="../../developers/index.html"/>
-      <item name="Maven Core ITs" href="../../core-its/index.html"/>
+      <!-- Developer documentation exists in separate repositories -->
+      <!--item name="Maven Developer Centre" 
href="../../developers/index.html"/-->

Review Comment:
   perhaps core-its require update, need to figure out
   but developers link is useful (and yes, outside: that's intended)



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to