diff --git a/administration/managing_custom_attestation_types/overview.md b/administration/managing_custom_attestation_types/overview.md index 24bf01a..166b23d 100644 --- a/administration/managing_custom_attestation_types/overview.md +++ b/administration/managing_custom_attestation_types/overview.md @@ -1,5 +1,5 @@ --- -title: Managing Custom Attestation Types +title: Managing custom attestation types description: Learn how to manage Kosli custom attestation types via Terraform, including creating and importing types with JSON Schema, jq evaluation rules, and summaries. --- diff --git a/administration/managing_environments/overview.md b/administration/managing_environments/overview.md index 5727f0b..72b2898 100644 --- a/administration/managing_environments/overview.md +++ b/administration/managing_environments/overview.md @@ -1,5 +1,5 @@ --- -title: Managing Environments +title: Managing environments description: Learn how to manage Kosli environments via Terraform, including creating and importing physical and logical environments. --- diff --git a/administration/managing_tags.md b/administration/managing_tags.md index dce25bc..5fdb112 100644 --- a/administration/managing_tags.md +++ b/administration/managing_tags.md @@ -1,5 +1,5 @@ --- -title: Managing Tags +title: Managing tags description: Use tags to label and organize Kosli resources with custom key-value pairs via Terraform, CLI, or API. --- diff --git a/config/navigation.json b/config/navigation.json index a536cb5..4886be2 100644 --- a/config/navigation.json +++ b/config/navigation.json @@ -2,7 +2,7 @@ "tabs": [ { "tab": "Documentation", - "groups": [ + "pages": [ { "group": "Understand Kosli", "icon": "book-open", @@ -60,18 +60,8 @@ "administration/managing_users/automated_user_provisioning" ] }, - { - "group": "Managing Environments", - "pages": [ - "administration/managing_environments/overview" - ] - }, - { - "group": "Managing Custom Attestation Types", - "pages": [ - "administration/managing_custom_attestation_types/overview" - ] - }, + "administration/managing_environments/overview", + "administration/managing_custom_attestation_types/overview", "administration/managing_tags" ] }, @@ -116,40 +106,15 @@ { "group": "Security", "pages": [ - { - "group": "Detecting Terraform drift", - "pages": [ - "tutorials/detecting_unexpected_statefile_changes", - "tutorials/detecting_non_terraform_changes" - ] - }, + "tutorials/detecting_unexpected_statefile_changes", + "tutorials/detecting_non_terraform_changes", "tutorials/rotating_api_keys" ] }, - { - "group": "Evaluation", - "pages": [ - "tutorials/evaluate_trails_with_opa" - ] - }, - { - "group": "Multi-flow workflows", - "pages": [ - "tutorials/linking_trails_across_branches" - ] - }, - { - "group": "Controls", - "pages": [ - "tutorials/working_with_controls" - ] - }, - { - "group": "Repositories", - "pages": [ - "tutorials/repositories" - ] - } + "tutorials/evaluate_trails_with_opa", + "tutorials/linking_trails_across_branches", + "tutorials/working_with_controls", + "tutorials/repositories" ] }, { @@ -165,13 +130,7 @@ "troubleshooting/whitespace_path" ] }, - { - "group": "FAQ", - "icon": "circle-question", - "pages": [ - "faq/faq" - ] - }, + "faq/faq", { "group": "Integrations", "icon": "puzzle-piece", @@ -190,7 +149,7 @@ "tab": "Labs", "groups": [ { - "group": "Kosli Learning Labs", + "group": "Kosli learning labs", "pages": [ "labs/index", "labs/lab-01-get-ready", @@ -206,36 +165,26 @@ "tab": "Implementation Guide", "groups": [ { - "group": "Phase 1: Initial Discovery", + "group": "Phase 1: initial discovery", "icon": "lightbulb", "pages": [ - { - "group": "Roles & Responsibilities", - "pages": [ - "implementation_guide/phase_1/roles_and_responsibilities/overview", - "implementation_guide/phase_1/roles_and_responsibilities/platform_engineers", - "implementation_guide/phase_1/roles_and_responsibilities/app_developers", - "implementation_guide/phase_1/roles_and_responsibilities/security_compliance", - "implementation_guide/phase_1/roles_and_responsibilities/sponsors" - ] - } + "implementation_guide/phase_1/roles_and_responsibilities/overview", + "implementation_guide/phase_1/roles_and_responsibilities/platform_engineers", + "implementation_guide/phase_1/roles_and_responsibilities/app_developers", + "implementation_guide/phase_1/roles_and_responsibilities/security_compliance", + "implementation_guide/phase_1/roles_and_responsibilities/sponsors" ] }, { - "group": "Phase 2: Configure Kosli", + "group": "Phase 2: configure Kosli", "icon": "gear", "pages": [ { - "group": "Plan Organizational Structure", + "group": "Naming conventions", "pages": [ - { - "group": "Naming Conventions", - "pages": [ - "implementation_guide/phase_2/plan_organizational_structure/naming_conventions/overview", - "implementation_guide/phase_2/plan_organizational_structure/naming_conventions/attestation_types", - "implementation_guide/phase_2/plan_organizational_structure/naming_conventions/flows_and_trails" - ] - } + "implementation_guide/phase_2/plan_organizational_structure/naming_conventions/overview", + "implementation_guide/phase_2/plan_organizational_structure/naming_conventions/attestation_types", + "implementation_guide/phase_2/plan_organizational_structure/naming_conventions/flows_and_trails" ] } ] @@ -465,13 +414,8 @@ { "item": "GitHub Action Reference", "icon": "github", - "groups": [ - { - "group": "GitHub Action", - "pages": [ - "github-action-reference/setup_cli_action" - ] - } + "pages": [ + "github-action-reference/setup_cli_action" ] }, { @@ -500,7 +444,7 @@ ] }, { - "group": "Data Sources", + "group": "Data sources", "pages": [ "terraform-reference/data-sources/environment", "terraform-reference/data-sources/logical_environment", @@ -513,7 +457,7 @@ ] }, { - "group": "List Resources", + "group": "List resources", "pages": [ "terraform-reference/list-resources/control" ] @@ -525,21 +469,16 @@ "icon": "layer-group", "groups": [ { - "group": "Helm Charts", - "pages": [ - { - "group": "Kubernetes Reporter", - "pages": [ - "helm/k8s_reporter/overview", - "helm/k8s_reporter/prerequisites", - "helm/k8s_reporter/installing", - "helm/k8s_reporter/upgrading", - "helm/k8s_reporter/uninstalling", - "helm/k8s_reporter/tls-proxy", - "helm/k8s_reporter/karpenter", - "helm/k8s_reporter/configuration" - ] - } + "group": "Kubernetes reporter", + "pages": [ + "helm/k8s_reporter/overview", + "helm/k8s_reporter/prerequisites", + "helm/k8s_reporter/installing", + "helm/k8s_reporter/upgrading", + "helm/k8s_reporter/uninstalling", + "helm/k8s_reporter/tls-proxy", + "helm/k8s_reporter/karpenter", + "helm/k8s_reporter/configuration" ] } ] @@ -547,13 +486,8 @@ { "item": "Template Reference", "icon": "file-code", - "groups": [ - { - "group": "Templates", - "pages": [ - "template-reference/flow_template" - ] - } + "pages": [ + "template-reference/flow_template" ] }, { @@ -575,13 +509,8 @@ { "tab": "Changelog", "icon": "clock", - "groups": [ - { - "group": "Changelog", - "pages": [ - "changelog/index" - ] - } + "pages": [ + "changelog/index" ] } ] diff --git a/config/redirects.json b/config/redirects.json index cbe6d8a..4bc6282 100644 --- a/config/redirects.json +++ b/config/redirects.json @@ -110,5 +110,25 @@ { "source": "/client_reference/kosli_request_approval", "destination": "/client_reference/overview" + }, + { + "source": "/kosli_overview/what_is_audit_trail", + "destination": "/understand_kosli/what_is_kosli" + }, + { + "source": "/implementation_guide/phase_2/sso_configuration", + "destination": "/administration/authentication/single_sign_on" + }, + { + "source": "/implementation_guide/phase_2/sso_configuration/entra_id_setup", + "destination": "/administration/authentication/single_sign_on" + }, + { + "source": "/implementation_guide/phase_2/sso_configuration/okta_setup", + "destination": "/administration/authentication/single_sign_on" + }, + { + "source": "/kosli-logo-dark-main.svg", + "destination": "/logo/kosli-logo-dark-main.svg" } ] diff --git a/faq/faq.md b/faq/faq.md index 2ad79cf..ba1a90f 100644 --- a/faq/faq.md +++ b/faq/faq.md @@ -1,6 +1,7 @@ --- title: FAQ description: "Frequently asked questions" +icon: circle-question --- diff --git a/getting_started/environments.md b/getting_started/environments.md index ed8723f..bd4283b 100644 --- a/getting_started/environments.md +++ b/getting_started/environments.md @@ -108,7 +108,7 @@ kosli tag env production-k8s \ Tags can also be referenced in [Environment Policy](/getting_started/policies) expressions to make attestation requirements conditional — for example, requiring security scans only for flows tagged `risk-level=high`. -For the full guide on managing tags, recommended patterns, and usage in policies, see [Managing Tags](/administration/managing_tags). +For the full guide on managing tags, recommended patterns, and usage in policies, see [Managing tags](/administration/managing_tags). ## Logical Environments diff --git a/implementation_guide/phase_1/roles_and_responsibilities/overview.md b/implementation_guide/phase_1/roles_and_responsibilities/overview.md index cc30634..e47eea4 100644 --- a/implementation_guide/phase_1/roles_and_responsibilities/overview.md +++ b/implementation_guide/phase_1/roles_and_responsibilities/overview.md @@ -1,5 +1,5 @@ --- -title: "Overview" +title: "Roles and responsibilities" description: "Define roles and responsibilities for Kosli implementation" --- diff --git a/template-reference/flow_template.md b/template-reference/flow_template.md index b4b46c9..b68a11b 100644 --- a/template-reference/flow_template.md +++ b/template-reference/flow_template.md @@ -1,5 +1,5 @@ --- -title: Flow Template +title: Flow template description: "Reference for the YAML template file used to define compliance controls for a Kosli flow." --- diff --git a/tutorials/working_with_controls.mdx b/tutorials/working_with_controls.mdx index 7851571..d19be6b 100644 --- a/tutorials/working_with_controls.mdx +++ b/tutorials/working_with_controls.mdx @@ -21,7 +21,7 @@ This tutorial covers how to: ## Prerequisites - [Install Kosli CLI](/getting_started/install). -- [Get a Kosli API token](/getting_started/service-accounts). +- [Get a Kosli API token](/getting_started/authenticating_to_kosli). - Have at least one [Flow](/getting_started/flows) and [Trail](/getting_started/trails) already created. ## Setup