Skip to content

Commit dec0416

Browse files
AlexKantor87claude
andcommitted
docs: tidy attestation types navigation
- Rename the first page from "Attestation types" to "Overview" so the group label and first-page title don't duplicate - Drop per-page icons in the new section (group icon removed; pages inherit the default styling) - Nest the individual system-type pages (currently just SARIF) under the catalogue page via a sub-group "Available system types" Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 5e8f176 commit dec0416

5 files changed

Lines changed: 8 additions & 8 deletions

File tree

attestation_types/overview.mdx

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
2-
title: Attestation types
2+
title: Overview
33
description: The three categories of attestation types in Kosli — custom, generic, and system — and when to use each.
4-
icon: stamp
54
---
65

76
An **attestation** records a fact (or a verdict) against a trail or artifact in a Kosli flow. An **attestation type** defines the shape of that record: what data it accepts, how Kosli validates it, and how the resulting tile renders in the UI.

attestation_types/system/catalogue.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: Available system types
33
description: The catalogue of system attestation types currently available in Kosli, with their versions and what each is for.
4-
icon: list
54
---
65

76
System attestation types ship with the Kosli platform — every organization can use any type listed below without setup.

attestation_types/system/overview.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: System attestation types
33
description: How system attestation types work — schema validation, default compliance, and tile rendering — and how they relate to custom and generic types.
4-
icon: cube
54
---
65

76
System attestation types are Kosli-curated attestation types available to every organization. They ship with:

attestation_types/system/sarif.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: "System type: SARIF"
33
description: The SARIF system attestation type — for recording the output of any SARIF v2.1.0 security scanner against a Kosli trail.
4-
icon: shield-halved
54
---
65

76
`system:sarif` is for attesting the output of any tool that produces SARIF v2.1.0 — Checkov, Trivy, Semgrep, Snyk, CodeQL, Bandit, and so on. Kosli parses the SARIF file, records the findings, and renders a severity-breakdown tile showing the tool name, version, and a list of findings with their locations.

config/navigation.json

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,15 +33,19 @@
3333
},
3434
{
3535
"group": "Attestation types",
36-
"icon": "stamp",
3736
"pages": [
3837
"attestation_types/overview",
3938
{
4039
"group": "System attestation types",
4140
"pages": [
4241
"attestation_types/system/overview",
43-
"attestation_types/system/catalogue",
44-
"attestation_types/system/sarif"
42+
{
43+
"group": "Available system types",
44+
"pages": [
45+
"attestation_types/system/catalogue",
46+
"attestation_types/system/sarif"
47+
]
48+
}
4549
]
4650
}
4751
]

0 commit comments

Comments
 (0)