docs: rewrite Antora docs using unified plugin template

- Add description with features, quick start, minimal setup, prerequisites
- Add configuration reference with complete example and individual params
- Rewrite usage with basic usage, decorator dependency, lifecycle
- Simplify license to uniform format
- Remove separate installation.adoc (merged into description)
- Simplify nav to single Start entry

Signed-off-by: jimisola <jimisola@jimisola.com>

Author: Jimisola Laursen

docs/modules/ROOT/nav.adoc

@@ -1,2 +1 @@
 * xref:index.adoc[Start]
-* xref:usage.adoc[Usage]

docs/modules/ROOT/pages/configuration.adoc

@@ -0,0 +1,70 @@
+== Configuration
+
+The plugin is configured in your `pyproject.toml` file under `[tool.hatch.build.hooks.reqstool]`.
+
+=== Complete Configuration Example
+
+[source,toml]
+----
+[tool.hatch.build.hooks.reqstool]
+# Build hook dependency
+dependencies = ["reqstool-python-hatch-plugin"]
+
+# Directories to scan for decorators
+# Default: ["src", "tests"]
+sources = ["src", "tests"]
+
+# Test result file pattern(s)
+# Default: "build/junit.xml"
+test_results = "build/junit.xml"
+
+# Directory containing requirements.yml and optional files
+# Default: "docs/reqstool"
+dataset_directory = "docs/reqstool"
+
+# Output directory for generated annotations
+# Default: "build/reqstool"
+output_directory = "build/reqstool"
+----
+
+=== Configuration Parameters
+
+==== sources
+
+Directories to scan for `@Requirements` and `@SVCs` decorators.
+Defaults to `["src", "tests"]`.
+
+[source,toml]
+----
+sources = ["src", "tests"]
+----
+
+==== test_results
+
+Path or pattern for test result files (JUnit XML).
+Defaults to `"build/junit.xml"`.
+
+[source,toml]
+----
+test_results = "build/junit.xml"
+----
+
+==== dataset_directory
+
+Directory containing `requirements.yml` and optional reqstool files (`software_verification_cases.yml`, `manual_verification_results.yml`).
+Defaults to `"docs/reqstool"`.
+
+[source,toml]
+----
+dataset_directory = "docs/reqstool"
+----
+
+==== output_directory
+
+Output directory for the generated `annotations.yml`.
+Defaults to `"build/reqstool"`.
+
+[source,toml]
+----
+output_directory = "build/reqstool"
+----

docs/modules/ROOT/pages/description.adoc

@@ -1,3 +1,53 @@
 == Description
 
-This documentation provides information on how to use the Reqstool Python Hatch Plugin. The plugin is designed to be used with the Hatch build tool and facilitates the integration of the Reqstool Python Decorators in your project.
+This Hatch build hook generates annotations and assembles reqstool data during `hatch build`. It collects decorated code using https://github.com/reqstool/reqstool-python-decorators[reqstool-python-decorators] and packages everything for consumption by the reqstool CLI.
+
+=== Features
+
+* *Hatch integration*: Runs automatically as a build hook during `hatch build`
+* *Combines annotations*: Collects `@Requirements` and `@SVCs` decorators from source and test code
+* *Assembles package data*: Includes requirements, test results, and annotations in the built package
+* *Generates config*: Creates a `reqstool_config.yml` with correct paths for the package structure
+
+=== Quick Start
+
+==== Add the Plugin
+
+Add the build hook dependency to your `pyproject.toml`:
+
+[source,toml]
+----
+[tool.hatch.build.hooks.reqstool]
+dependencies = ["reqstool-python-hatch-plugin"]
+----
+
+==== Default Behavior
+
+The plugin automatically:
+
+1. Runs during `hatch build`
+2. Scans source and test directories for `@Requirements` and `@SVCs` decorators
+3. Generates an `annotations.yml` file in `build/reqstool/`
+4. Creates a `reqstool_config.yml` with paths for the package structure
+5. Includes reqstool data in the built package (sdist/wheel)
+
+==== Minimal Setup
+
+[source]
+----
+my-project/
+├── pyproject.toml
+├── docs/
+│   └── reqstool/
+│       └── requirements.yml  (mandatory)
+├── src/
+└── tests/
+----
+
+Run `hatch build` and the annotations will be generated automatically.
+
+=== Prerequisites
+
+* Python 3.10+
+* https://hatch.pypa.io/[Hatch]
+* https://github.com/reqstool/reqstool-python-decorators[reqstool-python-decorators] as a project dependency

docs/modules/ROOT/pages/index.adoc

@@ -2,6 +2,8 @@
 
 include::description.adoc[]
 
-include::installation.adoc[]
+include::configuration.adoc[]
 
-include::license.adoc[]
+include::usage.adoc[]
+
+include::license.adoc[]

docs/modules/ROOT/pages/installation.adoc

@@ -1,3 +1,3 @@
 == License
 
-This project is licensed under the MIT License - see the LICENSE.md file for details.
+MIT License.

docs/modules/ROOT/pages/license.adoc

@@ -1,18 +1,44 @@
 == Usage
 
+=== Basic Usage
 
-=== Configuration
+Add the build hook to your `pyproject.toml`:
 
-The plugin can be configured through the `pyproject.toml` file. Configure plugin in `pyproject.toml`as follows;
-
-```toml
+[source,toml]
+----
 [tool.hatch.build.hooks.reqstool]
-dependencies = ["reqstool-python-hatch-plugin == <version>"]
+dependencies = ["reqstool-python-hatch-plugin"]
 sources = ["src", "tests"]
 test_results = "build/junit.xml"
 dataset_directory = "docs/reqstool"
 output_directory = "build/reqstool"
-```
-It specifies that the reqstool-python-hatch-plugin is a dependency for the build process, and it should be of a specific version. 
+----
+
+=== Decorator Dependency
+
+To use `@Requirements` and `@SVCs` decorators in your code, add the decorators package as a dependency:
+
+[source,toml]
+----
+[project]
+dependencies = ["reqstool-python-decorators"]
+----
+
+See https://github.com/reqstool/reqstool-python-decorators[reqstool-python-decorators] for decorator usage.
+
+=== Running the Build
+
+[source,bash]
+----
+hatch build
+----
+
+=== Default Lifecycle
+
+The plugin integrates into the Hatch build process:
 
-Further it defines the paths where the plugin should be applied. In this case, it specifies that the plugin should be applied to files in the src and tests directories. 
+1. `hatch build` is invoked
+2. The build hook scans `sources` directories for decorated code
+3. An `annotations.yml` is generated in the `output_directory`
+4. A `reqstool_config.yml` is created with paths for the package structure
+5. Reqstool data is included in the built sdist/wheel package