docs: documentation overhaul

CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# Contributing to reqstool-java-maven-plugin
+
+Thank you for your interest in contributing!
+
+For DCO sign-off, commit conventions, and code review process, see the organization-wide [CONTRIBUTING.md](https://github.com/reqstool/.github/blob/main/CONTRIBUTING.md).
+
+## Prerequisites
+
+- Java 21+
+- Maven 3.9+
+
+## Setup
+
+```bash
+git clone https://github.com/reqstool/reqstool-java-maven-plugin.git
+cd reqstool-java-maven-plugin
+```
+
+## Build & Test
+
+```bash
+mvn verify
+```

README.md

@@ -0,0 +1,55 @@
+[![Commit Activity](https://img.shields.io/github/commit-activity/m/reqstool/reqstool-java-maven-plugin?label=commits&style=for-the-badge)](https://github.com/reqstool/reqstool-java-maven-plugin/pulse)
+[![GitHub Issues](https://img.shields.io/github/issues/reqstool/reqstool-java-maven-plugin?style=for-the-badge&logo=github)](https://github.com/reqstool/reqstool-java-maven-plugin/issues)
+[![License](https://img.shields.io/github/license/reqstool/reqstool-java-maven-plugin?style=for-the-badge&logo=opensourceinitiative)](https://opensource.org/license/mit/)
+[![Build](https://img.shields.io/github/actions/workflow/status/reqstool/reqstool-java-maven-plugin/build.yml?style=for-the-badge&logo=github)](https://github.com/reqstool/reqstool-java-maven-plugin/actions/workflows/build.yml)
+[![Documentation](https://img.shields.io/badge/Documentation-blue?style=for-the-badge&link=docs)](https://reqstool.github.io)
+
+# Reqstool Maven Plugin
+
+Maven build plugin for [reqstool](https://github.com/reqstool/reqstool-client) that assembles requirements traceability artifacts.
+
+## Overview
+
+Collects `@Requirements` and `@SVCs` annotations from compiled Java code, combines them with test results, and packages everything into a ZIP artifact for analysis by the reqstool CLI.
+
+## Installation
+
+Add the plugin to your `pom.xml`:
+
+```xml
+<plugin>
+    <groupId>io.github.reqstool</groupId>
+    <artifactId>reqstool-maven-plugin</artifactId>
+    <version>1.0.4</version>
+    <executions>
+        <execution>
+            <goals>
+                <goal>assemble-and-attach-zip-artifact</goal>
+            </goals>
+        </execution>
+    </executions>
+    <configuration>
+        <datasetPath>${project.basedir}/docs/reqstool</datasetPath>
+    </configuration>
+</plugin>
+```
+
+## Usage
+
+```bash
+mvn clean verify
+```
+
+The plugin generates a ZIP artifact in `target/reqstool/` containing requirements, annotations, and test results.
+
+## Documentation
+
+Full documentation can be found [here](https://reqstool.github.io).
+
+## Contributing
+
+See the organization-wide [CONTRIBUTING.md](https://github.com/reqstool/.github/blob/main/CONTRIBUTING.md).
+
+## License
+
+MIT License.

docs/antora-playbook.yml

@@ -1,4 +1,5 @@
 # yaml-language-server: $schema=https://raw.githubusercontent.com/asciidoctor/asciidoctor-intellij-plugin/main/src/main/resources/jsonSchemas/antoraPlaybookSchema.json
+# For local development only. Published site: https://reqstool.github.io
 
 site:
   title: Reqstool Maven Plugin

docs/modules/ROOT/nav.adoc

@@ -1 +1,3 @@
-* xref:index.adoc[Start]
+* xref:index.adoc[Overview]
+* xref:configuration.adoc[Configuration]
+* xref:usage.adoc[Usage]