[framework-integrations] collection sources: collectionPath and content

.github/workflows/ci.yml

@@ -50,7 +50,7 @@ jobs:
 
   e2e:
     needs: [changes, lint_unit_tests_and_builds]
-    if: needs.changes.outputs.renderer == 'true' && (github.event_name == 'push' || github.event.pull_request.draft == false)
+    if: needs.changes.outputs.renderer == 'true'
     runs-on: ubuntu-latest
     defaults:
       run:
@@ -78,6 +78,8 @@ jobs:
           retention-days: 30
 
   changes:
+    # nothing runs on a draft; marking it ready is a trigger of its own
+    if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
     runs-on: ubuntu-latest
     outputs:
       renderer: ${{ steps.filter.outputs.renderer }}
@@ -90,8 +92,10 @@ jobs:
           filters: |
             renderer:
               - '!integrations/**'
+              - '!examples/integrations/**'
             integrations:
               - 'integrations/**'
+              - 'examples/integrations/**'
               - '.github/workflows/ci.yml'
               - '.github/workflows/integrations-matrix.yml'
 

.github/workflows/integrations-matrix.yml

@@ -6,7 +6,7 @@ on:
     - cron: '0 6 * * 1'
   pull_request:
     branches: [main, 'release/**']
-    types: [labeled, synchronize]
+    types: [labeled, synchronize, ready_for_review]
 
 permissions:
   contents: read
@@ -22,7 +22,7 @@ env:
 
 jobs:
   cells:
-    if: github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'run-integrations-matrix-tests')
+    if: github.event_name != 'pull_request' || (github.event.pull_request.draft == false && contains(github.event.pull_request.labels.*.name, 'run-integrations-matrix-tests'))
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -53,7 +53,7 @@ jobs:
           path: integrations/results
 
   node-20:
-    if: github.event_name != 'pull_request' || contains(github.event.pull_request.labels.*.name, 'run-integrations-matrix-tests')
+    if: github.event_name != 'pull_request' || (github.event.pull_request.draft == false && contains(github.event.pull_request.labels.*.name, 'run-integrations-matrix-tests'))
     runs-on: ubuntu-latest
     continue-on-error: true
     name: node 20 (end of life, courtesy)

README.md

@@ -53,7 +53,7 @@ See [Auto-generate documentation](https://docs.usebruno.com/api-docs/auto-genera
 | Path | What it is |
 |---|---|
 | [`packages/bruno-api-docs`](./packages/bruno-api-docs) | The renderer: a React app built as a library and as the **standalone bundle** (`dist-standalone/`), the artifact the Bruno app's generated HTML loads from the CDN. |
-| [`examples/`](./examples) | Consumption patterns: `standalone-html` (how a generated HTML file uses the bundle), `react` and `express-server` (design sketches of the intended embedding API; not shipped packages yet, see Roadmap). |
+| [`examples/`](./examples) | `standalone-html`, how a generated HTML page uses the bundle. `integrations/nodejs`, runnable examples for the framework packages, one folder per framework. |
 
 ## Roadmap