Skip to content

docs: add tutorial for trail summaries in GitHub and GitLab pipelines#272

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/05c0cb9a
Open

docs: add tutorial for trail summaries in GitHub and GitLab pipelines#272
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/05c0cb9a

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Adds a short tutorial showing how to publish a Kosli trail as a markdown summary on GitHub Actions and GitLab CI pipeline runs, based on the new kosli get trail --output markdown flag introduced in kosli-dev/cli#953.

Changes

  • New page: tutorials/trail_summaries_in_ci.md
    • Describes what the markdown output contains (trail metadata, git commit, attestation statuses with ✅/❌/⏳ + (+) for unexpected, events table) and the links it produces back to the Kosli app.
    • GitHub Actions recipe: append to $GITHUB_STEP_SUMMARY with if: always() so the summary still publishes on failure.
    • GitLab CI recipe: produce a summary.md artifact with expose_as so it shows on the job page and as an MR annotation.
  • Navigation: added under Tutorials → Querying & tracing.

Validated with mint validate and mint broken-links.

Requested in Slack by Mike Long.


Generated by Mintlify Agent.

Requested by: mike@kosli.com via Slack
Mintlify session: slack_1781594108.178939_C01UMS1CEN5

@mintlify mintlify Bot requested a review from a team as a code owner June 17, 2026 10:02
@mintlify

mintlify Bot commented Jun 17, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
kosli 🟢 Ready View Preview Jun 17, 2026, 10:04 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants