From 65caab8f0587a9ca3ca928afbb12188552b04069 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Mon, 16 Mar 2026 17:40:09 -0300 Subject: [PATCH] Add gRPC as governable API type and update AMF doc links Replicate PR #107 changes: - Add gRPC to API type lists in index.adoc, dashboard-overview.adoc, and dashboard-key-metrics.adoc - Update create-custom-rulesets.adoc: AMF supported formats (gRPC), AMF Custom Validation link, MuleSoft Ideas Portal link - Update custom-rulesets-new.adoc: AMF Custom Validation link, MuleSoft Ideas Portal link Made-with: Cursor --- modules/ROOT/pages/_partials/dashboard-key-metrics.adoc | 2 +- modules/ROOT/pages/create-custom-rulesets.adoc | 6 +++--- modules/ROOT/pages/custom-rulesets-new.adoc | 4 ++-- modules/ROOT/pages/dashboard-overview.adoc | 2 +- modules/ROOT/pages/index.adoc | 2 +- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/modules/ROOT/pages/_partials/dashboard-key-metrics.adoc b/modules/ROOT/pages/_partials/dashboard-key-metrics.adoc index 1c7939e0..a6b56f68 100644 --- a/modules/ROOT/pages/_partials/dashboard-key-metrics.adoc +++ b/modules/ROOT/pages/_partials/dashboard-key-metrics.adoc @@ -25,7 +25,7 @@ Actionable Metrics:: *View APIs* takes you to the API Governance Console, where == APIs by Type -Definition:: APIs in your catalog by type, specifically *REST API, AsyncAPI, HTTP API, Agent, and MCP*. +Definition:: APIs in your catalog by type, specifically *REST API, AsyncAPI, HTTP API, gRPC, Agent, and MCP*. Displayed Count:: The dashboard shows the count of all APIs by type. Actionable Metrics:: *View APIs* takes you to the API Governance Console, where you can view a list of APIs by type with details and the option to download a list of APIs by type. diff --git a/modules/ROOT/pages/create-custom-rulesets.adoc b/modules/ROOT/pages/create-custom-rulesets.adoc index e4fb31b2..94078294 100644 --- a/modules/ROOT/pages/create-custom-rulesets.adoc +++ b/modules/ROOT/pages/create-custom-rulesets.adoc @@ -2,7 +2,7 @@ include::general::partial$api-gov-concepts.adoc[tag=governance-rulesets-subset] -Rulesets are implemented using AMF, an open-source framework for managing metadata documents. AMF parses, transforms, validates, and renders arbitrary metadata models, with built-in features for API models. Anypoint Platform uses AMF to parse RAML, OAS, AsyncAPI, and GraphQL API specifications. +Rulesets are implemented using AMF, an open-source framework for managing metadata documents. AMF parses, transforms, validates, and renders arbitrary metadata models, with built-in features for API models. Anypoint Platform uses AMF to parse RAML, OAS, AsyncAPI, GraphQL, and gRPC API specifications. If you need a ruleset other than those provided, you can create your own custom ruleset. @@ -10,11 +10,11 @@ If you need a ruleset other than those provided, you can create your own custom By writing your own rules, you can govern your APIs with your organization's specific regulations and standards. Take some time to get familiar with the ruleset development CLI commands and ruleset language concepts before you start customizing rulesets. -You can also submit your ideas for rulesets you would like MuleSoft to provide in future releases on the https://help.mulesoft.com/s/ideas[MuleSoft Ideas Portal^]. +You can also submit your ideas for rulesets you would like MuleSoft to provide in future releases on the https://ideas.salesforce.com/s/search[MuleSoft Ideas Portal^]. When you're ready to get started: -. Read https://a.ml/docs/amf/using-amf/amf_custom_validation/[Custom Validation^] for a brief summary of how rulesets validate APIs. +. Read https://salesforce-misc.github.io/amf-docs/docs/amf/using-amf/amf_custom_validation[Custom Validation^] for a brief summary of how rulesets validate APIs. . If you plan to create completely new custom rulesets that aren't based on existing ones, follow the https://github.com/aml-org/amf-custom-validator/blob/develop/docs/validation_tutorial/validation.md[AMF Rulesets tutorial^] to install the ruleset development CLI. . Install Anypoint CLI. You'll need this to validate your custom rulesets, generate their documentation, and publish them to Exchange. diff --git a/modules/ROOT/pages/custom-rulesets-new.adoc b/modules/ROOT/pages/custom-rulesets-new.adoc index d400464e..b59e933c 100644 --- a/modules/ROOT/pages/custom-rulesets-new.adoc +++ b/modules/ROOT/pages/custom-rulesets-new.adoc @@ -5,7 +5,7 @@ endif::[] To create a completely new custom ruleset that isn't based on an existing one, use one of the following approaches: -* Search the https://help.mulesoft.com/s/ideas[MuleSoft Ideas Portal^] for ideas for new rulesets. If you don't find your idea there, consider submitting your idea in the MuleSoft Ideas Portal. +* Search the https://ideas.salesforce.com/s/search[MuleSoft Ideas Portal^] for ideas for new rulesets. If you don't find your idea there, consider submitting your idea in the MuleSoft Ideas Portal. * Generate a ruleset using Anypoint CLI commands by scaffolding it from a specification's data schema. See <>. * Create a ruleset using the ruleset development CLI commands, see <>. * Create a ruleset using the ruleset modeling language, see <>. @@ -49,7 +49,7 @@ To create rulesets using the ruleset development CLI: [[create-rulesets-using-code]] == Create Rulesets Using the Modeling Language -To create rulesets using the modeling language, read the https://a.ml/docs/amf/using-amf/amf_custom_validation[AMF Custom Validation section^] in the AML Open Source project to learn how to write a ruleset using the modeling language. +To create rulesets using the modeling language, read the https://salesforce-misc.github.io/amf-docs/docs/amf/using-amf/amf_custom_validation[AMF Custom Validation section^] in the AML Open Source project to learn how to write a ruleset using the modeling language. == See Also diff --git a/modules/ROOT/pages/dashboard-overview.adoc b/modules/ROOT/pages/dashboard-overview.adoc index b3e6980f..0ed0d244 100644 --- a/modules/ROOT/pages/dashboard-overview.adoc +++ b/modules/ROOT/pages/dashboard-overview.adoc @@ -14,7 +14,7 @@ Metrics:: Access a pre-built set of metrics to understand your API surface area. Actions:: Each metric is associated with potential actions you can take from the dashboard to improve your API posture. Organization-wide Visibility:: View a pre-built set of metrics for each of your organizations. Clear Status Overview:: Instantly see the status of your APIs, including those that are unprotected, governed, in Exchange, and in production. -API Type Breakdown:: Understand the distribution of your APIs by type (for example, REST API, AsyncAPI, HTTP API, Agent, MCP). +API Type Breakdown:: Understand the distribution of your APIs by type (for example, REST API, AsyncAPI, HTTP API, gRPC, Agent, MCP). Governance Insights:: Gain visibility into your API governance posture, including the number of governed APIs, their conformance status, and nonconformance severity. [[dashboard-metrics]] diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc index dd0620f6..156cf0bb 100644 --- a/modules/ROOT/pages/index.adoc +++ b/modules/ROOT/pages/index.adoc @@ -38,7 +38,7 @@ The API Governance Dashboard offers an organization-wide view of your API landsc From the API Governance Dashboard, you can: * View metrics, such as the number of unprotected APIs, governed APIs, APIs in Exchange, and APIs in production. -* Understand the distribution of your APIs by type, including REST API, AsyncAPI, HTTP API, Agent, and MCP. +* Understand the distribution of your APIs by type, including REST API, AsyncAPI, HTTP API, gRPC, Agent, and MCP. * Understand your API governance posture, including conformance status and nonconformance severity for governed APIs. * Take action from the Dashboard based on the presented metrics, such as initiating the creation of new governance profiles to start governing unprotected APIs and navigating to lists of APIs for further review.