[GH] (fluss/fix-1314-lake-plugin-shadowing): Workflow run "Check Documentation" failed!

[GitBox <gi...@apache.org>]

The GitHub Actions job "Check Documentation" on fluss.git/fix-1314-lake-plugin-shadowing has failed.
Run started by GitHub user gezapeti (triggered by gezapeti).

Head commit for run:
5f4e0dd600f2008e0fc4e84919357bfbd949f72b / Peter Cseh <ge...@gmail.com>
[docs] Document plugin placement and add plugin troubleshooting

Two docs pages linked to /downloads#filesystem-jars, but the downloads
page had no such section. Add it, listing the filesystem plugin jars of
the latest release and which of them the binary release already ships,
so both links resolve.

Also spell out the choice between the two artifacts serving hdfs://:
fluss-fs-hdfs bundles Hadoop and is what the distribution ships, while
the thin fluss-fs-hadoop expects Hadoop via HADOOP_CLASSPATH. Exactly
one of them should be installed. The filesystem overview still credited
fluss-fs-hadoop for the bundled plugin, which has been fluss-fs-hdfs
since the artifacts were split.

Add a troubleshooting page explaining how plugins are loaded, why a jar
copied into <FLUSS_HOME>/lib shadows the copy under plugins/ and loses
the dependencies bundled next to it, and what each resulting error
means. Warn about it where users hit it: the filesystem overview, the
lakehouse deployment guide, and the downloads page. The lakehouse guide
also now says explicitly that its ${FLINK_HOME}/lib instructions are
about the Flink installation, not the Fluss one.

This addresses items (2) and (6) of the analysis in #1314.

Co-Authored-By: Claude Opus 5 <no...@anthropic.com>
Claude-Session: https://claude.ai/code/session_019dqbppMMENgRMdJxwv5GuM

Report URL: https://github.com/apache/fluss/actions/runs/33647134453

With regards,
GitHub Actions via GitBox