Improve docs around requiremments and language support

Author: ascopes

protobuf-maven-plugin/src/site/markdown/other-language-support.md

@@ -6,6 +6,8 @@ While Maven does not provide official plugins for most other programming
 languages, the protobuf-maven-plugin allows you to generate source code for
 a number of other programming languages.
 
+## Languages directly supported by `protoc`
+
 By default, only Java generation is enabled. You can turn this off if desired.
 
 To enable other languages, use the following attributes within your `configuration` block;
@@ -53,12 +55,29 @@ To enable other languages, use the following attributes within your `configurati
   </tbody>
 </table>
 
+### Further support
+
 Any other languages natively available in `protoc` can be enabled by passing `<arguments/>`
-in the plugin configuration (e.g. `--cpp_out=target/cpp` for C++).
+in the plugin configuration. For example:
+
+```xml
+<configuration>
+  <arguments>
+    <argument>--cpp_out=target/generated-sources/cxx</argument>
+  </arguments>
+  <protoc>...</protoc>
+</configuration>
+```
+
+## Languages and tooling without first-class support
 
 Any other language integrations can be provided to this plugin in the shape of
 third-party custom `protoc` plugins.
 
+See "[using protoc plugins](./using-protoc-plugins.md)" for full details.
+
+### Caveats
+
 It is also important to note that you need to provide a valid compiler or tooling to
 make use of the generared sources (other than Java). For example, Kotlin generation
 would require you to also configure the `kotlin-maven-plugin`. See 

protobuf-maven-plugin/src/site/markdown/requirements.md

@@ -99,3 +99,21 @@ Refer to the `protocVersion` parameter documentation on the
 
 You may also try something like `docker buildx` and use a cross-platform container to build
 on the desired platform. Virtual machines are also an option.
+
+## "But Google released binaries for this architecture!"
+
+In the unlikely event that Google adds new architecture support as a first class citizen
+to `protoc`, please raise a
+[feature request](https://github.com/ascopes/protobuf-maven-plugin/issues)
+and I will get onto it as soon as possible.
+
+## What about this WASM thing I've heard about?
+
+Some projects like Quarkus have began to experiment with transpiling
+`protoc` to web assembly, enabling them to be run in a WASM interpreter
+within the JVM, or within Graal's polyglot runtime.
+
+This is something that I am looking to eventually support where possible.
+If you are interested in helping out with this, please reach out on the
+[discussions](https://github.com/ascopes/protobuf-maven-plugin/discussions)
+page.

scripts/site-local.sh

@@ -11,8 +11,15 @@ set -o pipefail
 
 readonly host=127.0.0.1
 readonly port=9000
+base_dir=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
+site_dir=${base_dir}/protobuf-maven-plugin/target/site
+
+if [[ ! -d ${site_dir} ]] || [[ "${*}" =~ .*--build.* ]]; then
+  cd "${base_dir}"
+  ./mvnw site -Dlicense.skip -Dcheckstyle.skip -Dinvoker.skip -Dmaven.test.skip -T10
+fi
+cd "${site_dir}"
 
-cd "$(git rev-parse --show-toplevel)/protobuf-maven-plugin/target/site"
 python3 -m http.server -b "${host}" "${port}" &
 readonly pid=$!
 trap 'kill -SIGTERM "$pid" &> /dev/null; trap - EXIT INT TERM' EXIT INT TERM