online english manual is blank, Chinese manual is partially visible, Please check the source code！

[wyzhihai]

[awxiaoxian2020]

Related to mybatis/parent#600

[AgostinoX]

I confirm that I cannot read content (english version).

[Jason7158]

Also need the annotation documentation!

[Hugh-Ross4]

Lots of people impacted by this. Any alternative links to MyBatis-3 documentation that are still working?
Thanks..

[harawata]

Hi,

I'm sorry for the inconvenience.
I think @hazendaz is working on it.

For the meantime, please use the wayback machine.
https://web.archive.org/web/20240303085253/https://mybatis.org/mybatis-3/index.html

Or you can build the site locally.

git clone https://github.com/mybatis/mybatis-3.git
cd mybatis-3
git checkout mybatis-3.5.16
./mvnw clean site -Dlicense.skip=true -Dmaven.test.skip=true

The HTMLs will be generated in ./target/site/ directory.

I would recommend modifying the locales in the pom.xml to shorten the build time.

diff --git a/pom.xml b/pom.xml
index a8413790a2..43ce196258 100644
--- a/pom.xml
+++ b/pom.xml
@@ -442,7 +442,7 @@
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-site-plugin</artifactId>
         <configuration>
-          <locales>default,es,ja,fr,zh_CN,ko</locales>
+          <locales>default</locales>
         </configuration>
       </plugin>
       <plugin>

[hazendaz]

@harawata I did run the 'site' GHA and it ran ok, the files were updated, but noticed the site never published to org.mybatis. Do you know if there is something else missing there or maybe does it exclude showing snapshots? I'd hate to do a formal release with really no reason other than site but if that is the case, we probably could do so but in that case, let me release the parent again to pickup a few additional items from maven. I know this could be worse, maven broke half their sites documentation due to using maven 4 to run the site for 3. Not the case here but seems documentation problems all over.

[harawata]

@hazendaz ,

When I ran ./mvnw site against the master locally, the English site is blank (same as the online site), so I assumed that there was some issue with Markdown processor.
Does it generate the site correctly on your machine?

[hazendaz]

Thanks @harawata I'll give a try in a few days. Maybe the original defect that resulting in changing the locales is now fixed again. Maven is having a bumpy right here. It is nice to see its problematic locally so I'll give it a shot and see what I can come up with. Will be this coming weekend..

[harawata]

I have reverted the site to 3.5.16 version, so it should be fine for now.
If someone finds a way to fix the blank site, please send us a PR.

[awxiaoxian2020]

Maybe related to https://maven.apache.org/docs/3.9.8/release-notes.html#potentially-breaking-core-changes-if-migrating-from-3-8-x