Modernize gh-pages branch: Jekyll -> plain Markdown for VitePress hub

Replaces the flat Jekyll (cayman theme) file layout on this branch
with a docs/ folder of plain Markdown: VitePress-compatible
frontmatter, kebab-case slugs, rewritten internal cross-links. Docs
stay on this dedicated branch, fully separated from the module's
source code on master, matching the previous gh-pages/Jekyll
convention but modernized for consumption by the
DirectProjectJavaRI.github.io VitePress hub.

Adds a repository_dispatch workflow so the hub site rebuilds
automatically when these docs change.

Author: gm2552

.github/workflows/notify-docs-hub.yml

@@ -0,0 +1,18 @@
+name: Notify docs hub
+
+on:
+  push:
+    branches: [gh-pages]
+    paths:
+      - 'docs/**'
+
+jobs:
+  dispatch:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Fire repository_dispatch to DirectProjectJavaRI.github.io
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ secrets.DOCS_DISPATCH_TOKEN }}
+          repository: DirectProjectJavaRI/DirectProjectJavaRI.github.io
+          event-type: docs-updated

DevGuide.md

@@ -1,3 +1,7 @@
+---
+title: Security and Trust Agent Architecture and Components
+---
+
 # Security and Trust Agent Architecture and Components
 
 At a high level the agent can be viewed as a black box that implements the DirectProject [specification](http://wiki.directproject.org/w/images/e/e6/Applicability_Statement_for_Secure_Health_Transport_v1.2.pdf). Digging deeper into the box, the agent consists of a directly consumable API and several subsystems that can be directly consumed as stand-alone components.
@@ -8,11 +12,11 @@ Each component within the agent functions independently whilst the agent orchest
 
 ##### Core Components and Interfaces
 
-* [NHINDAgent](NHINDAgent): Interface specification for the security and trust agent. Incoming and outgoing messages are processed by the agent according to the DirectProject [specification](http://wiki.directproject.org/w/images/e/e6/Applicability_Statement_for_Secure_Health_Transport_v1.2.pdf). [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/NHINDAgent.html)
-* [Cryptographer](Cryptographer): Interface specification for message encryption/decryption and message signature operations. [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/cryptography/Cryptographer.html)
-* [CertificateResolver](CertResolver): Certificate resolvers are responsible for locating public and private X509 certificates for destination and source addresses. Certificates are used for encryption/decryption, message signing, and signature validation. [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/cert/CertificateResolver.html)
-* [TrustModel](Trust): Interface specification for the trust enforcement policy. Trust is enforced by trust anchors, revocation policies, and an optional set of intermediate certificates. [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/trust/TrustModel.html)
-* [Mail Library](MailLib): Contains utility classes and specific implementations of agent mail classes. The majority of the classes are built on the [JavaMail](http://java.sun.com/products/javamail/javadocs/index.html) API. [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/mail/package-summary.html)
+* [NHINDAgent](nhind-agent): Interface specification for the security and trust agent. Incoming and outgoing messages are processed by the agent according to the DirectProject [specification](http://wiki.directproject.org/w/images/e/e6/Applicability_Statement_for_Secure_Health_Transport_v1.2.pdf). [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/NHINDAgent.html)
+* [Cryptographer](cryptographer): Interface specification for message encryption/decryption and message signature operations. [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/cryptography/Cryptographer.html)
+* [CertificateResolver](cert-resolver): Certificate resolvers are responsible for locating public and private X509 certificates for destination and source addresses. Certificates are used for encryption/decryption, message signing, and signature validation. [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/cert/CertificateResolver.html)
+* [TrustModel](trust): Interface specification for the trust enforcement policy. Trust is enforced by trust anchors, revocation policies, and an optional set of intermediate certificates. [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/trust/TrustModel.html)
+* [Mail Library](mail-lib): Contains utility classes and specific implementations of agent mail classes. The majority of the classes are built on the [JavaMail](http://java.sun.com/products/javamail/javadocs/index.html) API. [JavaDoc](http://api.directproject.info/agent/2.2.1/apidocs/org/nhindirect/stagent/mail/package-summary.html)
 
 Typically messages are processed by the agent using the appropriate incoming or outgoing method and return either a processed message or throw an exception if the message cannot be processed.