Merge pull request #29 from quickfix-j/copilot/add-threading-guides-to-sidebar

Add threading guides as external sidebar links and cross-reference from docs

Author: chrjohn

docs/architecture.md

@@ -66,3 +66,5 @@ QuickFIX/J offers distinct threading models for connection handling, tailored fo
 
 2. **ThreadedSocketAcceptor / ThreadedSocketInitiator (One-Thread-Per-Session)**
    Spawns a dedicated thread for processing messages on each connection. Ideal for scenarios with a small number of high-throughput connections where you want to eliminate context-switching overhead and allocate maximum CPU time directly to message processing.
+
+For a deep technical reference on the threading internals — including the `EventHandlingStrategy` implementations, the `QFJ Timer` thread, `Session.next()` behaviour, and queue back-pressure — see the [Threading Model Technical Reference](https://github.com/quickfix-j/quickfixj/blob/master/docs/threading-model.md).

docs/developer-docs.md

@@ -240,4 +240,7 @@ void sendOrderCancelRequest() {
 ```
 
 ### Note on Threading
+
 `Session.sendToTarget()` is thread-safe. You can call it from any thread in your application. The message will be serialized, persisted to the `MessageStore`, and placed on the socket's write buffer asynchronously.
+
+For a full explanation of QuickFIX/J's threading strategies (single-threaded vs. thread-per-session), queue capacity configuration, and thread safety requirements for your `Application` implementation, see the [Threading Developer Guide](https://github.com/quickfix-j/quickfixj/blob/master/docs/threading-developer-guide.md).

sidebars.ts

@@ -21,6 +21,11 @@ const sidebars: SidebarsConfig = {
       items: [
         'architecture',
         'use-cases',
+        {
+          type: 'link',
+          label: 'Threading Model (Technical Reference)',
+          href: 'https://github.com/quickfix-j/quickfixj/blob/master/docs/threading-model.md',
+        },
       ],
     },
     {
@@ -32,6 +37,11 @@ const sidebars: SidebarsConfig = {
         'repeating-groups',
         'user-defined-fields',
         'validation',
+        {
+          type: 'link',
+          label: 'Threading Developer Guide',
+          href: 'https://github.com/quickfix-j/quickfixj/blob/master/docs/threading-developer-guide.md',
+        },
       ],
     },
     {