You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2026/08/09 23:02:57 UTC

(maven-scripting-plugin) 01/01: Remove the empty FAQ page

This is an automated email from the ASF dual-hosted git repository.

slachiewicz pushed a commit to branch remove-empty-faq-page
in repository https://gitbox.apache.org/repos/asf/maven-scripting-plugin.git

commit d6c2473b96f77a70a920a5957b3ff98d6be784e3
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Aug 10 01:02:42 2026 +0200

    Remove the empty FAQ page
    
    src/site/fml/faq.fml has never held a single <faq> entry since it was
    added in 2021. It renders faq.html as nothing but the heading
    "Frequently Asked Questions", and it is the only faq.fml in the Maven
    estate that its own site.xml does not put in a menu, so the page is
    reachable only from the sentence in index.md.vm that this commit also
    drops - archetype boilerplate that invites the reader to consult a FAQ
    that does not exist.
    
    This removes faq.html from the published site. That is a URL that will
    start returning 404, which is worth stating plainly, but the page has no
    content to deep-link to and no menu entry pointing at it.
    
    Verified by building the site before and after: faq.html is the only
    page that disappears, the remaining 20 build clean, and no reference to
    it is left anywhere in the repository.
    
    Generated-by: Claude Opus 5 (1M context)
---
 src/site/fml/faq.fml          | 28 ----------------------------
 src/site/markdown/index.md.vm |  4 ++--
 2 files changed, 2 insertions(+), 30 deletions(-)

diff --git a/src/site/fml/faq.fml b/src/site/fml/faq.fml
deleted file mode 100644
index 257c4d4..0000000
--- a/src/site/fml/faq.fml
+++ /dev/null
@@ -1,28 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<!--
-Licensed to the Apache Software Foundation (ASF) under one
-or more contributor license agreements.  See the NOTICE file
-distributed with this work for additional information
-regarding copyright ownership.  The ASF licenses this file
-to you under the Apache License, Version 2.0 (the
-"License"); you may not use this file except in compliance
-with the License.  You may obtain a copy of the License at
-
-  http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing,
-software distributed under the License is distributed on an
-"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, either express or implied.  See the License for the
-specific language governing permissions and limitations
-under the License.
--->
-
-
-<faqs xmlns="http://maven.apache.org/FML/1.0.1"
-  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-  xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd"
-  id="FAQ" title="Frequently Asked Questions">
-  
-</faqs>
\ No newline at end of file
diff --git a/src/site/markdown/index.md.vm b/src/site/markdown/index.md.vm
index 17b168c..9de0054 100644
--- a/src/site/markdown/index.md.vm
+++ b/src/site/markdown/index.md.vm
@@ -33,8 +33,8 @@ Usage
   General instructions on how to use the Scripting Plugin can be found on the 
   [usage page](./usage.html). 
 
-  In case you still have questions regarding the plugin's usage, please have a look at the 
-  [FAQ](./faq.html) and feel free to contact the [user mailing list](./mailing-lists.html). 
+  In case you still have questions regarding the plugin's usage, please feel free to contact
+  the [user mailing list](./mailing-lists.html).
   The posts to the mailing list are archived and could already contain the answer to your 
   question as part of an older thread. Hence, it is also worth browsing/searching
   the [mail archive](./mailing-lists.html).