Reorganize Tests and Documentation Structure

.github/workflows/aarch64-ebclfsa.yml

@@ -25,7 +25,7 @@ jobs:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: ./examples
+        working-directory: ./tests
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v6
@@ -38,4 +38,4 @@ jobs:
           cache-save: ${{ github.event_name == 'push' }}
       - name: Bazel Build (basic)
         run: |
-          bazel build --lockfile_mode=error --config target_config_5 -- //:main_cpp
+          bazel build --lockfile_mode=error --config=aarch64-linux-ebclfsa -- //:language_and_standards_tests //:feature_verification_tests

.github/workflows/aarch64-linux.yml

@@ -21,11 +21,11 @@ on:
     types: [checks_requested]
   workflow_call:
 jobs:
-  target_config_3:
+  generic-aarch64-linux:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: ./examples
+        working-directory: ./tests
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v6
@@ -38,24 +38,4 @@ jobs:
           cache-save: ${{ github.event_name == 'push' }}
       - name: Bazel Build (basic)
         run: |
-          bazel build --config target_config_3 -- //...
-      - name: Upload artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: build-output
-          path: examples/bazel-bin/
-  run_on_target:
-    runs-on: ubuntu-24.04-arm
-    needs: target_config_3
-    steps:
-      - name: Download artifact
-        uses: actions/download-artifact@v5
-        with:
-          name: build-output
-          path: downloaded/
-      - name: Use artifact
-        run: |
-          chmod 755 ./downloaded/main_cpp
-          chmod 755 ./downloaded/main_pthread_cpp
-          ./downloaded/main_cpp
-          ./downloaded/main_pthread_cpp
+          bazel build --config=aarch64-linux -- //:language_and_standards_tests //:feature_verification_tests

.github/workflows/autosd.yml

@@ -21,11 +21,11 @@ on:
     types: [checks_requested]
   workflow_call:
 jobs:
-  target_config_4:
+  x86_64-linux-autosd10:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: ./examples
+        working-directory: ./tests
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v6
@@ -38,4 +38,4 @@ jobs:
           cache-save: ${{ github.event_name == 'push' }}
       - name: Bazel Build (basic)
         run: |
-          bazel build --lockfile_mode=error --config target_config_4 -- //:main_cpp //:main_pthread_cpp //:math_lib //:math_lib_shared
+          bazel build --lockfile_mode=error --config=x86_64-linux-autosd10 -- //:language_and_standards_tests //:feature_verification_tests

.github/workflows/x86_64-linux.yml

@@ -21,11 +21,11 @@ on:
     types: [checks_requested]
   workflow_call:
 jobs:
-  host_config_1:
+  generic-x86_64-linux:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: ./examples
+        working-directory: ./tests
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v6
@@ -38,7 +38,7 @@ jobs:
           cache-save: ${{ github.event_name == 'push' }}
       - name: Bazel Build (basic)
         run: |
-          bazel build --lockfile_mode=error --config host_config_1 -- //...
+          bazel build --lockfile_mode=error --config=x86_64-linux -- //:language_and_standards_tests //:feature_verification_tests
       - name: Bazel Test
         run: |
-          bazel test --config host_config_1 -- //...
+          bazel test --config=x86_64-linux -- //:language_and_standards_tests //:feature_verification_tests

README.md

@@ -23,7 +23,7 @@ packages reproducibly.
 
 The documentation below is organized around the main subsystems of the
 repository: how consumers declare toolchains, how Bazel repositories are
-generated, how platform packages are described, how the example workspace
+generated, how platform packages are described, how the test workspace
 validates the setup, and how QNX-specific authentication and licensing fit in.
 
 ## Documentation
@@ -34,6 +34,7 @@ validates the setup, and how QNX-specific authentication and licensing fit in.
 - [Generation flow](docs/generation_flow.md)
 - [Examples and validation](docs/examples_and_validation.md)
 - [QNX integration](docs/qnx_integration.md)
+- [Test Suite](docs/test_suite.md) - Comprehensive test documentation
 - [Maintenance](docs/maintenance.md)
 
 ## Quick Summary
@@ -44,11 +45,11 @@ validates the setup, and how QNX-specific authentication and licensing fit in.
 
 **Primary consumer entry point:** `@score_bazel_cpp_toolchains//extensions:gcc.bzl`
 
-**Main validation surface:** `examples/` smoke-test workspace
+**Main validation surface:** `tests/` smoke-test workspace
 
 ## Key Capabilities
 
 - Define Linux and QNX toolchains through a Bzlmod extension.
 - Resolve default package metadata through `packages/version_matrix.bzl`.
 - Generate toolchain repositories from platform-specific templates.
-- Validate toolchain selections through the example workspace test matrix.
+- Validate toolchain selections through the workspace test matrix.