This is an automated email from the ASF dual-hosted git repository.
fanningpj pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/poi.git
The following commit(s) were added to refs/heads/trunk by this push:
new 8e5d6fe026 update docs
8e5d6fe026 is described below
commit 8e5d6fe026e279bd1f38c2292166700f9eb5531c
Author: PJ Fanning <pjfann...@users.noreply.github.com>
AuthorDate: Tue Jul 8 03:40:26 2025 +0100
update docs
---
.asf.yaml | 1 -
src/documentation/publish-poi-site.txt | 23 ++++++++++++++++++-----
2 files changed, 18 insertions(+), 6 deletions(-)
diff --git a/.asf.yaml b/.asf.yaml
index 613368f48e..1a86da9ed9 100644
--- a/.asf.yaml
+++ b/.asf.yaml
@@ -44,4 +44,3 @@ notifications:
publish:
whoami: asf-site
- subdir: publish
diff --git a/src/documentation/publish-poi-site.txt
b/src/documentation/publish-poi-site.txt
index c60cd7918b..c0456e77d9 100644
--- a/src/documentation/publish-poi-site.txt
+++ b/src/documentation/publish-poi-site.txt
@@ -47,15 +47,28 @@ Building and Deploying the Site
It is recommended that you open a command prompt and set up Java 8 as your
default. The web site build will fail
if you use a very recent Java version.
-In your local copy of the POI svn (https://github.com/apache/poi/tree/trunk),
run:
+In your local copy of the POI git (https://github.com/apache/poi/tree/trunk),
run using Java 8:
ant site
-After this completes, you can copy the files in `build/site` to the `publish`
directory in your poi-site checkout
-(https://github.com/apache/poi/tree/asf-site).
+If you use a newer version, you will get warnings and the output will have
issues.
+
+After this completes, you can switch to the `asf-site` branch.
+
+The `ant site` command will have created a directory called `build/site` in
your local POI git checkout.
+You can copy the files in `build/site` to the `content` directory.
+This `content` directory is where the files for the web site are stored
+and only appears in the `asf-site` branch.
A command like this might work.
-cp -r ~/poi/build/site/* ~/poi-site/publish/
+cp -R build/site/* content/
+
+I would recommend that you use `git status` and `git diff` before committing
the changes to asf-site.
+
+It is probably a good idea to check the site locally before committing the
changes by opening the
+content/index.html file in a browser.
+
+Once you are happy with the changes, you can commit them to the `asf-site`
branch.
-I would recommend that you use `git status` and `git diff` before committing
the changes to poi-site.
+It is probably a good idea to merge the changes to the `trunk` branch as well
but that won't affect the web site.
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@poi.apache.org
For additional commands, e-mail: commits-h...@poi.apache.org
