Merge pull request #807 from ascopes/task/security-docs

Include GH contributing guide and security notes in generated site

Author: ascopes

CONTRIBUTING.md

@@ -18,7 +18,6 @@ Make sure you provide full details of what you are trying to do and why. Include
 what you expect to happen, versus what actually happens. Run `mvn` or `mvnw` in your project
 with the `--errors` flag to get full exception stacktraces.
 
-> [!IMPORTANT]
 > If possible and appropriate, try to show `protoc` being called directly and producing the output you
 > expect.
 
@@ -87,7 +86,6 @@ This project uses semantic versioning!
 If you need to add a new user-facing feature (i.e. something that is accessible via the interface used in
 a `pom.xml` when using this plugin), you should bump the minor version of this plugin.
 
-> [!NOTE]
 > If you are making a breaking API change, you need to bump the major version.
 
 I'll advise about this during PR reviews as needed, but you can use the `scripts/bump-versions.sh` script

protobuf-maven-plugin/src/site/markdown/gh-contributing.md

@@ -0,0 +1 @@
+../../../../CONTRIBUTING.md

protobuf-maven-plugin/src/site/markdown/gh-security.md

@@ -0,0 +1 @@
+../../../../SECURITY.md

protobuf-maven-plugin/src/site/site.xml

@@ -56,8 +56,6 @@
     <menu name="Documentation">
       <item name="Introduction" href="index.html"/>
       <item name="Goals" href="plugin-info.html"/>
-      <item name="Requirements" href="requirements.html"/>
-      <item name="Known Issues" href="known-issues.html"/>
     </menu>
     <menu name="Guides">
       <item name="Basic Usage" href="basic-usage.html"/>
@@ -67,14 +65,18 @@
       <item name="Descriptor Files" href="descriptor-files.html"/>
       <item name="Examples" href="examples.html"/>
       <item name="Faster Builds" href="faster-builds.html"/>
+      <item name="Known Issues" href="known-issues.html"/>
       <item name="Other Language Support" href="other-language-support.html"/>
+      <item name="Requirements" href="requirements.html"/>
       <item name="Using Protoc Plugins" href="using-protoc-plugins.html"/>
     </menu>
     <menu name="Releases">
       <item name="GitHub" href="https://github.com/ascopes/protobuf-maven-plugin/releases"/>
       <item name="Maven Central" href="https://central.sonatype.com/artifact/io.github.ascopes/protobuf-maven-plugin"/>
     </menu>
     <menu name="Development">
+      <item name="Contributing Guide" href="gh-contributing.html"/>
+      <item name="Security Policy" href="gh-security.html"/>
       <item name="Issues and Bugs" href="https://github.com/ascopes/protobuf-maven-plugin/issues"/>
       <item name="Discussions" href="https://github.com/ascopes/protobuf-maven-plugin/discussions"/>
       <item name="Source Code" href="https://github.com/ascopes/protobuf-maven-plugin"/>