Skip to content

Commit 93adb14

Browse files
Add source callout to example walk-through docs
Inserts a Material ``!!! info "Source"`` admonition between the H1 and the lead paragraph on every example walk-through doc. The admonition links the page's main.py on the LunarCommand GitHub repo (``/blob/main/examples/<name>/main.py``), opening in a new tab via ``{target="_blank" rel="noopener"}``. Applied to all 13 walk-throughs (one callout each): chat-with-multimodal, checkpointing-and-migration, explicit-subgraph-mapping, fan-out-with-retry, hello-world, langfuse-observability, multimodal-prompt, nested-subgraphs, observer-hooks, parallel-branches, production-observability, routing-and-subgraphs, tool-use. Styling: overrides the default Material info-admonition accent to the project lavender (rgb(228, 193, 249)); inside the admonition, slate-theme link color shifts to the body-text gray (rgba(226, 228, 233, 0.82)) so the URL reads as content rather than as a highlighted action against the lavender backdrop. URLs use the LunarCommand org for now; will need a one-line perl substitution after the OpenArmature org move per the project_org_move_to_openarmature memory.
1 parent dfd71e0 commit 93adb14

14 files changed

Lines changed: 76 additions & 0 deletions

docs/examples/chat-with-multimodal.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Chat with multi-turn memory and a multimodal turn
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/chat-with-multimodal/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/chat-with-multimodal/main.py){target="_blank" rel="noopener"}
5+
36
A lunar-mission Q&A assistant that maintains conversation context
47
across four turns. One mid-conversation turn includes an attached
58
photograph (Apollo 16 Lunar Module "Orion" on the lunar surface):

docs/examples/checkpointing-and-migration.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Checkpointing and migration
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/checkpointing-and-migration/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/checkpointing-and-migration/main.py){target="_blank" rel="noopener"}
5+
36
A lunar-mission planning pipeline that writes a SQLite checkpoint
47
after every step, survives a simulated mid-pipeline crash, and then
58
resumes the saved invocation under an upgraded state schema with a

docs/examples/explicit-subgraph-mapping.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Explicit subgraph mapping
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/explicit-subgraph-mapping/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/explicit-subgraph-mapping/main.py){target="_blank" rel="noopener"}
5+
36
Compare two topics by running the *same* compiled analysis subgraph
47
on each, with each call site writing into disjoint parent fields.
58
This is the canonical use of `ExplicitMapping`.

docs/examples/fan-out-with-retry.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Fan-out with retry
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/fan-out-with-retry/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/fan-out-with-retry/main.py){target="_blank" rel="noopener"}
5+
36
Summarize a batch of lunar-mission headlines in parallel, with
47
per-headline retry and timing middleware wrapping each instance's
58
subgraph run.

docs/examples/hello-world.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Hello, world
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/hello-world/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/hello-world/main.py){target="_blank" rel="noopener"}
5+
36
The smallest possible LLM-routed pipeline: classify a query, then
47
either plan research on it or summarize it in one sentence. Sets the
58
shape every other example builds on.

docs/examples/langfuse-observability.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Langfuse observability
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/langfuse-observability/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/langfuse-observability/main.py){target="_blank" rel="noopener"}
5+
36
Send LLM call observability to Langfuse natively: Trace at the top,
47
Span observations for graph nodes, Generation observations with input,
58
output, token usage, model parameters, and a native link back to the

docs/examples/multimodal-prompt.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Multimodal prompt
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/multimodal-prompt/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/multimodal-prompt/main.py){target="_blank" rel="noopener"}
5+
36
Two independent analyses of a lunar-mission photograph using
47
versioned prompt templates, a fallback prompt backend, and a
58
multimodal user message that carries both text and image.

docs/examples/nested-subgraphs.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Nested subgraphs
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/nested-subgraphs/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/nested-subgraphs/main.py){target="_blank" rel="noopener"}
5+
36
Question answering against a tiny baked-in document corpus, with
47
two levels of subgraph nesting: outer coordinator, middle doc-QA,
58
inner section-extract.

docs/examples/observer-hooks.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Observer hooks
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/observer-hooks/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/observer-hooks/main.py){target="_blank" rel="noopener"}
5+
36
Add observability to a `draft → review → finalize` pipeline without
47
touching any node code. Three observer flavors run side-by-side: a
58
console tracer, a per-invocation metrics collector, and the

docs/examples/parallel-branches.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Parallel branches
22

3+
!!! info "Source"
4+
[https://github.com/LunarCommand/openarmature-python/blob/main/examples/parallel-branches/main.py](https://github.com/LunarCommand/openarmature-python/blob/main/examples/parallel-branches/main.py){target="_blank" rel="noopener"}
5+
36
Enrich a lunar-mission news article with three independent
47
analyses (one-sentence summary, sentiment label, topic tags)
58
running concurrently as separate subgraphs.

0 commit comments

Comments
 (0)