Align AkôFlow documentation narrative and examples - #43

Merged

ovvesley merged 188 commits into

mainfrom

docs/editorial-consistency

Sep 13, 2026

Commits on Sep 12, 2026

docs: align onboarding narrative and API conventions
ovvesley
committed
928dea5
docs: track page-by-page editorial audit
ovvesley
committed
64ed4a1
docs: qualify partial AWS S3 support
ovvesley
committed
f81d64a
docs: distinguish declared GCS support from unavailable transfer
ovvesley
committed
0d22179
docs: qualify Desktop-only workflow path
ovvesley
committed
5360908
docs: simplify planning and execution evidence explanations
ovvesley
committed
dce294b
docs: record full tutorial review
ovvesley
committed
01e6976
docs: clarify environment and artifact guide entry points
ovvesley
committed
4d88810
docs: correct cloud target and topology procedures
ovvesley
committed
de415fd
docs: align workflow narrative and execution states
ovvesley
committed
f9744fb
docs: standardize operation guides around user tasks
ovvesley
committed
1e9c326
docs: turn production plan into ongoing editorial contract
ovvesley
committed
85dd95b
docs: simplify concepts and Desktop tour
ovvesley
committed
680e1a6
docs: distinguish verified Showcase runs from Desktop inspection
ovvesley
committed
c5b66b1
docs: link generated core POST pages to verified payloads
ovvesley
committed
f0e717b
docs: align GCP onboarding and finish authored page read
ovvesley
committed
7eac295
docs: qualify hidden Desktop topology creation path
ovvesley
committed
c60f407
docs: add verified Desktop first local workflow
ovvesley
committed
83debb5
docs: add handler-checked API request notes
ovvesley
committed
b41c20d
docs: guide readers from interface tour to first run
ovvesley
committed
91fa091
docs: clarify planning session request contract
ovvesley
committed
624ba53
docs: refresh editorial evidence ledger
ovvesley
committed
1072acd
docs: align quality plan with verified first run
ovvesley
committed
0143328
docs: record mobile first-run navigation check
ovvesley
committed
24fa9be
docs: protect credential import examples
ovvesley
committed
e0853c2
docs: stream credential payloads without temporary files
ovvesley
committed
cafe58d
docs: clarify storage promotion examples and contracts
ovvesley
committed
60966b6
docs: make cloud target and API token examples safe
ovvesley
committed
3fc34ae
docs: remove incomplete workflow request from API overview
ovvesley
committed
c068570
docs: qualify unlinked Desktop network routes
ovvesley
committed
e05a925
docs: standardize versioned Showcase setup
ovvesley
committed
bc52c5b
docs: clarify runtime support and planning narrative
ovvesley
committed
8636cef
docs: clarify storage operation contracts
ovvesley
committed
c9c3ba0
docs: align artifact examples with API contracts
ovvesley
committed
c5ed784
docs: correct console outcomes and operation contracts
ovvesley
committed
259dc36
docs: fix generated request shapes and simplify API pages
ovvesley
committed
ec87672
docs: restore qualified API response examples
ovvesley
committed
6662a95
docs: align entry path with verified local run
ovvesley
committed
afc3fc2
docs: separate GCP target project from credential owner
ovvesley
committed
dae9d1b

Commits on Sep 13, 2026

docs: secure Kubernetes token example and remote setup path
ovvesley
committed
62fdf36
docs: clarify workflow examples and console history
ovvesley
committed
6f5c3d4
docs: preserve instance identity in settings example
ovvesley
committed
11e2299
docs: make scope and topology examples navigable
ovvesley
committed
4e7b92a
docs: make workflow specification example coherent
ovvesley
committed
52a8e95
docs: correct environment revision guidance
ovvesley
committed
e85b179
docs: fix server tunnel command and simplify operations guidance
ovvesley
committed
e76c102
docs: complete HPC registration path
ovvesley
committed
2b8c17e
docs: validate fenced shell examples in CI
ovvesley
committed
4cc0440
docs: clarify instance and environment API contracts
ovvesley
committed
2564f04
docs: align environment and topology defaults with API persistence
ovvesley
committed
66195e7
docs: document connection and workflow action contracts
ovvesley
committed
d6efd54
docs: make cloud capacity path follow GCP tutorial
ovvesley
committed
2c7fbd2
docs: clarify planning cancellation responses
ovvesley
committed
62cecd1
docs: carry chosen planning candidate through API example
ovvesley
committed
82d85fa
docs: make provenance and audit API examples complete
ovvesley
committed
e52d1f8
docs: derive artifact guide IDs from inventory
ovvesley
committed
c98f93c
docs: complete interactive console API sequence
ovvesley
committed
2812070
docs: make operation lookup examples self-contained
ovvesley
committed
58f36e5
docs: clarify destructive API and resource contracts
ovvesley
committed
d155f90
docs: cover every mutating API route with checked guidance
ovvesley
committed
adc999e
docs: label inferred API samples as field shapes
ovvesley
committed
60638b6
docs: simplify scheduler explanation and correct network units
ovvesley
committed
6e0896d
docs: simplify installation entry path
ovvesley
committed
562e9f4
docs: simplify interface tour and align first-run navigation
ovvesley
committed
7e21120
docs: explain partial S3 support in user terms
ovvesley
committed
636dee9
docs: simplify HPC setup narrative
ovvesley
committed
a810b39
docs: verify provenance SQL request examples
ovvesley
committed
2c4641f
docs: verify playbook validation request
ovvesley
committed
2f27df0
docs: verify machine configuration request sequence
ovvesley
committed
9e7289b
docs: show multipart build-context upload in API reference
ovvesley
committed
e57caa7
docs: verify Docker artifact registration example
ovvesley
committed
d63cb66
docs: align storage promotion JSON contracts
ovvesley
committed
06fdbaf
docs: verify storage operation request bodies
ovvesley
committed
84d2446
docs: show minimal console request bodies
ovvesley
committed
e1bc1c5
docs: verify local connection test request
ovvesley
committed
4918c8c
docs: verify instance preferences and preserve update state
ovvesley
committed
46d3c19
docs: verify workflow import and duplicate requests
ovvesley
committed
4c45c24
docs: verify inventory-only resource request
ovvesley
committed
c539025
test: format resource request fixture for repository checks
ovvesley
committed
34c46d1
docs: avoid fictitious replacement request bodies
ovvesley
committed
0520240
docs: qualify artifact operation requests
ovvesley
committed
e80a6a4
docs: remove placeholder credential requests
ovvesley
committed
aed7499
docs: correct queued cloud statuses and request notes
ovvesley
committed
cffe7be
docs: verify generated endpoint success statuses
ovvesley
committed
9f64cc3
docs: present WebSocket and response shapes accurately
ovvesley
committed
4ed6ef3
docs: correct daemon health API command
ovvesley
committed
6e33d98
docs: label console handshake as WebSocket upgrade
ovvesley
committed
0232008
docs: qualify dynamic preflight results
ovvesley
committed
daba7e7
docs: clarify infrastructure examples and validation limits
ovvesley
committed
46adba5
docs: streamline installation verification path
ovvesley
committed
245c989
docs: keep onboarding claims and concepts focused
ovvesley
committed
7c3763d
docs: make planning guide task first
ovvesley
committed
00b237c
docs: separate provenance and audit tasks
ovvesley
committed
06690c5
docs: preserve SSH connection fields during key rotation
ovvesley
committed
3edfd67
docs: separate record search and notifications
ovvesley
committed
d0457cf
docs: align GCP catalog commands with tutorial environment
ovvesley
committed
d1df634
docs: simplify console access narrative
ovvesley
committed
6cc6204
docs: focus execution guide on planned workflows
ovvesley
committed
9b07ad6
docs: separate artifact build and location tasks
ovvesley
committed
57a7968
docs: focus SSH and preferences guides
ovvesley
committed
3072dea
docs: separate cloud worker configuration from capacity
ovvesley
committed
322a755
docs: clarify onboarding support and focus installation
ovvesley
committed
ea14e24
docs: introduce workflow fields only when needed
ovvesley
committed
b7da58b
docs: lead evidence guides with investigation steps
ovvesley
committed
dc09bd8
docs: correct cloud target provisioning prerequisites
ovvesley
committed
91f0ed3
docs: correct fixed-plan prediction semantics
ovvesley
committed
a8b3db9
docs: add concrete saved-plan import path
ovvesley
committed
a970e13
docs: verify and fix saved-plan import example
ovvesley
committed
fba0084
docs: complete Docker artifact build walkthrough
ovvesley
committed
db55dd8
docs: align planning narrative with prediction models
ovvesley
committed
00d9b7b
docs: explain SimGrid route selection accurately
ovvesley
committed
38377b3
docs: distinguish artifact records from live verification
ovvesley
committed
41d27a5
docs: align contributor contract with generated API pages
ovvesley
committed
080bb6b
docs: clarify missing network routes by scheduler
ovvesley
committed
9ffd9ca
docs: simplify showcase limits and purpose
ovvesley
committed
4c87c50
docs: verify JSX commands and authenticate Showcase polling
ovvesley
committed
332242e
docs: complete storage download and archive flow
ovvesley
committed
9a67b02
fix: persist archive download path and document local storage
ovvesley
committed
067ea60
docs: qualify HPC workspace and GCP catalog results
ovvesley
committed
95f5e6d
docs: separate coverage maintenance from public route map
ovvesley
committed
5c037f2
docs: authenticate root health checks
ovvesley
committed
99f515f
docs: make API examples fail on HTTP errors
ovvesley
committed
a262bfd
docs: group cloud endpoints with cloud guidance
ovvesley
committed
47388cc
docs: align entry wording and verify API overview routes
ovvesley
committed
42c5812
docs: describe actual cloud zone selection
ovvesley
committed
d3aeafd
docs: distinguish S3 transfer and browser credentials
ovvesley
committed
173f998
docs: surface S3 browsing limit in storage guide
ovvesley
committed
310da89
docs: keep one editorial writing contract
ovvesley
committed
474891a
docs: align planning and evidence explanations
ovvesley
committed
4cbbfd2
docs: correct generated map response shapes
ovvesley
committed
a524b4f
fix(docs): make mobile sidebar opaque
ovvesley
committed
e779a38
docs: focus infrastructure tutorial narratives
ovvesley
committed
6d6557e
docs: separate cloud support from capacity procedure
ovvesley
committed
e5a335b
docs: point notification recovery to operation records
ovvesley
committed
411f711
docs: qualify asynchronous cloud provisioning acceptance
ovvesley
committed
9c77689
docs: clarify cloud operation response lifecycle
ovvesley
committed
3dd5b9c
docs: keep SLURM login node out of default plans
ovvesley
committed
fcf11bd
docs: make plan execution explicit in entry narrative
ovvesley
committed
902469d
docs: prevent filled arrow paths in architecture diagrams
ovvesley
committed
333632b
docs: explain cloud catalog and inventory read behavior
ovvesley
committed
139c6c1
docs: align artifact evidence wording across guides
ovvesley
committed
9d0deff
docs: match Audit narrative to emitted events
ovvesley
committed
84ee22a
docs: simplify dense reference and quality prose
ovvesley
committed
52b02b1
docs: clarify topology selection in network explanation
ovvesley
committed
5da0d58
docs: show Docker artifact registration response fields
ovvesley
committed
12bcfd7
docs: expose execution detail response families
ovvesley
committed
9af6d84
docs: clarify planning instance and provenance response shapes
ovvesley
committed
a93c958
docs: clarify cloud provisioning log identity and timing
ovvesley
committed
c2bb30f
docs: prevent ambiguous null and false primitive response shapes
ovvesley
committed
e7cb2eb
docs: correct plan creation response contract
ovvesley
committed
ac55c32
docs: scope troubleshooting evidence to recorded events
ovvesley
committed
fd4e1b7
docs: align first-run narrative with manual plan and visible result
ovvesley
committed
9ee6764
docs: use server terminology in basic user paths
ovvesley
committed
5a54192
docs: align data evidence tasks with verified scope
ovvesley
committed
9015c42
docs: remove duplicated preferences procedure
ovvesley
committed
72cc0f0
docs: align planning and execution user path
ovvesley
committed
4e2787a
docs: align planning and evidence explanations
ovvesley
committed
413c4f6
docs: standardize descriptions across authored pages
ovvesley
committed
aec1e1a
docs: simplify scope reference and local showcase openings
ovvesley
committed
ab3a826
docs: standardize server wording in showcase paths
ovvesley
committed
4e5d331
docs: connect first-run and infrastructure reading paths
ovvesley
committed
4eda697
docs: qualify modeled showcase resources and Kind evidence
ovvesley
committed
eb46f6d
docs: clarify architecture scope and runtime narrative
ovvesley
committed
2f15db3
docs: correct execution recovery and retry claims
ovvesley
committed
bbeaa9d
docs: qualify queue recovery and SLURM cancellation
ovvesley
committed
2d2a5b3
docs: align task status guidance with persisted states
ovvesley
committed
6be8fde
docs: use specific titles and query guidance in API pages
ovvesley
committed
cbd82fd
docs: distinguish checked and inferred API responses
ovvesley
committed
c47c321
docs: replace synthetic provenance response rows
ovvesley
committed
49cbeb8
docs: remove ambiguous array items from API examples
ovvesley
committed
98f9827
docs: distinguish environment recommendations from schema checks
ovvesley
committed
a5208f9
docs: correct nested environment ID requirements
ovvesley
committed
a0fdcaa
docs: remove ignored environment binding fields from authoring
ovvesley
committed
142a2ff
docs: align environment response examples with persisted fields
ovvesley
committed
1a5cae9
docs: separate planning resource filters from runtime bindings
ovvesley
committed
ff5b76d
docs: clarify that plan feasibility is not runtime readiness
ovvesley
committed
d0baf70
docs: keep first-user promise focused on run results
ovvesley
committed
0888517
docs: keep SLURM login node out of batch scheduling
ovvesley
committed
3e2d882
docs: qualify first-contact HPC SSH host trust
ovvesley
committed
d1a245c
docs: use stable routes for client-side navigation
ovvesley
committed
769f6e0
docs: simplify execution and runtime internals
ovvesley
committed
0b50e8e
docs: state factory reset retention limits
ovvesley
committed
8b53d8a
docs: separate update notices from operation notifications
ovvesley
committed
4b260b1
docs: standardize Desktop and API path headings
ovvesley
committed
cc64420
docs: map remaining Desktop detail routes
ovvesley
committed
0a595be
docs: make result evidence path more direct
ovvesley
committed
9c1da88
docs: identify Windows release asset as portable
ovvesley
committed
7b215b8
docs: close editorial iteration with verified scope
ovvesley
committed
6409678