You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by ro...@apache.org on 2022/11/11 17:51:40 UTC

[activemq-website] 04/04: Also make the serve_subset.sh config exclude the javadocs now the full serve/build is faster. Gets rebuilds down to ~1 sec.

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

robbie pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/activemq-website.git

commit 2b01745bd951e0fb13e62793dc01c8118c4e792a
Author: Robbie Gemmell <ro...@apache.org>
AuthorDate: Fri Nov 11 17:49:14 2022 +0000

    Also make the serve_subset.sh config exclude the javadocs now the full serve/build is faster. Gets rebuilds down to ~1 sec.
---
 README.md                   | 2 +-
 _config_subset_excludes.yml | 7 +++++--
 serve_subset.sh             | 6 ++++--
 3 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 3c7202403..a026a65f4 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,7 @@ If for some reason you need to clear the metadata/cache used to support the buil
 There is a `./clean.sh` helper script provided that does the above.
 
 Note there is also a `./serve_subset.sh` helper script. This uses additional configuration from `_config_subset_excludes.yml` to omit building
-older release content that doesnt typically change, significantly improving responsiveness while working on additions not affecting those areas.
+larger content like javadocs and older release content that doesnt typically change, significantly improving responsiveness while working on additions not affecting those areas.
 It works best when starting without existing full _site output, which can be cleaned out as noted above.
 
 Contributing to the site
diff --git a/_config_subset_excludes.yml b/_config_subset_excludes.yml
index 35b2f62f5..6148a955a 100644
--- a/_config_subset_excludes.yml
+++ b/_config_subset_excludes.yml
@@ -1,9 +1,12 @@
-# Additional site settings, with more excludes to omit various older content, only
-# leaving the smaller subset more typically updated, giving a much faster [re]build.
+# Additional site settings, with more excludes to omit various larger content,
+# like the javadocs, and also older release content, only leaving the smaller
+# subset more typically [live-]updated, giving a much faster [re-]build.
 
 # These need to be exact paths, not wildcards.
 exclude: [
 vendor,
+maven/apidocs,
+components/artemis/documentation/javadocs/javadoc-latest,
 components/cms/api_docs,
 components/nms/msdoc,
 components/artemis/documentation/1.0.0,
diff --git a/serve_subset.sh b/serve_subset.sh
index 45113a278..14e24fea3 100755
--- a/serve_subset.sh
+++ b/serve_subset.sh
@@ -4,8 +4,10 @@ bundle install
 # metadata based generation used in release process updates
 # and isnt dramatically faster regardless.
 echo "=========================== WARNING ==============================="
-echo "Various content excluded for perf, see _config_subset_excludes.yml."
-echo "Run the full serve/build process to test changes in those areas."
+echo "Various content excluded for perf, *including the javadocs*."
+echo "See _config_subset_excludes.yml for the full list."
+echo ""
+echo "Run a full serve.sh/build.sh process to test changes in those areas."
 echo "==================================================================="
 bundle exec jekyll serve --config _config.yml,_config_subset_excludes.yml --livereload
 set +e