CLOUDP-329196: update doc links to new format - part 2 (#4028)

Author: andreaangiolillo

docs/command/atlas-api.txt

@@ -22,7 +22,7 @@ Admin API capabilities have their own release lifecycle, which you can check via
 This feature in public preview streamlines script development by letting you interact directly with any Atlas Administration API endpoint by using the Atlas CLI.
 
 For more information on
-- Atlas Administration API see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/
+- Atlas Administration API see: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/
 - Getting started with the Atlas Administration API: https://www.mongodb.com/docs/atlas/configure-api-access/#std-label-atlas-admin-api-access
 
 Public Preview: The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli).

docs/command/atlas-federatedAuthentication-federationSettings-connectedOrgConfigs-update.txt

@@ -49,7 +49,7 @@ Options
    * - --file
      - string
      - true
-     - Path to a JSON configuration file that defines connected orgs configurations. Note: Unsupported fields in the JSON file are ignored. To learn more about connected org configuration file format, see the request body in https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateConnectedOrgConfig.
+     - Path to a JSON configuration file that defines connected orgs configurations. Note: Unsupported fields in the JSON file are ignored. To learn more about connected org configuration file format, see the request body in https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateconnectedorgconfig.
    * - -h, --help
      - 
      - false

docs/command/atlas-organizations-apiKeys-assign.txt

@@ -81,7 +81,7 @@ Options
    * - --role
      - strings
      - false
-     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateApiKey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles. Passing this flag replaces preexisting data.
+     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateapikey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles. Passing this flag replaces preexisting data.
 
 Inherited Options
 -----------------

docs/command/atlas-organizations-apiKeys-create.txt

@@ -63,7 +63,7 @@ Options
    * - --role
      - strings
      - true
-     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createApiKey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles.
+     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles.
 
 Inherited Options
 -----------------

docs/command/atlas-organizations-create.txt

@@ -65,7 +65,7 @@ Options
    * - --apiKeyRole
      - strings
      - false
-     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createApiKey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles. Required when creating organizations authenticated with API Keys.
+     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles. Required when creating organizations authenticated with API Keys.
    * - --federationSettingsId
      - string
      - false

docs/command/atlas-projects-apiKeys-assign.txt

@@ -75,7 +75,7 @@ Options
    * - --role
      - strings
      - true
-     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/addProjectApiKey. To learn more about project level user roles, see: https://dochub.mongodb.org/core/atlas-proj-roles.
+     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectapikey. To learn more about project level user roles, see: https://dochub.mongodb.org/core/atlas-proj-roles.
 
 Inherited Options
 -----------------

docs/command/atlas-projects-apiKeys-create.txt

@@ -64,7 +64,7 @@ Options
    * - --role
      - strings
      - true
-     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createProjectApiKey. To learn more about project level user roles, see: https://dochub.mongodb.org/core/atlas-proj-roles.
+     - Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectapikey. To learn more about project level user roles, see: https://dochub.mongodb.org/core/atlas-proj-roles.
 
 Inherited Options
 -----------------

internal/cli/api/api.go

@@ -75,7 +75,7 @@ func createRootAPICommand() *cobra.Command {
 		Long: `This feature in public preview streamlines script development by letting you interact directly with any Atlas Administration API endpoint by using the Atlas CLI.
 
 For more information on
-- Atlas Administration API see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/
+- Atlas Administration API see: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/
 - Getting started with the Atlas Administration API: https://www.mongodb.com/docs/atlas/configure-api-access/#std-label-atlas-admin-api-access`,
 	}
 

internal/usage/usage.go

@@ -144,10 +144,10 @@ dbName and collection are required only for built-in roles.`
 	OrgIncludeDeleted                             = "Flag that indicates whether to include deleted organizations in the list. This option applies only to Ops Manager organizations. You can't return deleted Atlas or Cloud Manager organizations."
 	APIKeyDescription                             = "Description of the API key."
 	AtlasAPIKeyDescription                        = APIKeyDescription + " " + requiredForAtlas
-	CreateProjectAPIKeyRoles                      = "Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createProjectApiKey. To learn more about project level user roles, see: https://dochub.mongodb.org/core/atlas-proj-roles." //nolint:gosec // This is just a message not a credential
-	AddProjectAPIKeyRoles                         = "Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/addProjectApiKey. To learn more about project level user roles, see: https://dochub.mongodb.org/core/atlas-proj-roles."    //nolint:gosec // This is just a message not a credential
-	CreateAPIKeyRoles                             = "Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createApiKey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles."    //nolint:gosec // This is just a message not a credential
-	UpdateAPIKeyRoles                             = "Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateApiKey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles."    //nolint:gosec // This is just a message not a credential
+	CreateProjectAPIKeyRoles                      = "Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectapikey. To learn more about project level user roles, see: https://dochub.mongodb.org/core/atlas-proj-roles." //nolint:gosec // This is just a message not a credential
+	AddProjectAPIKeyRoles                         = "Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectapikey. To learn more about project level user roles, see: https://dochub.mongodb.org/core/atlas-proj-roles."    //nolint:gosec // This is just a message not a credential
+	CreateAPIKeyRoles                             = "Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles."    //nolint:gosec // This is just a message not a credential
+	UpdateAPIKeyRoles                             = "Role or roles that you want to assign to the API key. To assign more than one role, specify each role with a separate role flag or specify all of the roles as a comma-separated list using one role flag. For the full list of accepted values, see the Items Enum for the corresponding Atlas API endpoint: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateapikey. To learn more about organization level user roles, see: https://dochub.mongodb.org/core/atlas-org-roles."    //nolint:gosec // This is just a message not a credential
 	AtlasAPIKeyRoles                              = CreateAPIKeyRoles + " " + requiredForAtlas
 	NotificationRegion                            = "Region that indicates which API URL to use."
 	NotificationDelayMin                          = "Number of minutes to wait after an alert condition is detected before sending out the first notification."
@@ -406,7 +406,7 @@ dbName and collection are required only for built-in roles.`
 	RequestedScopes            = "Scopes that MongoDB applications will request from the authorization endpoint.	"
 	Protocol                   = "Protocol used to authenticate the user. Valid value is OIDC or SAML."
 	IdentityProviderID         = "Unique identifier of the identity provider."
-	ConnectedOrgConfigFilename = "Path to a JSON configuration file that defines connected orgs configurations. Note: Unsupported fields in the JSON file are ignored. To learn more about connected org configuration file format, see the request body in https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateConnectedOrgConfig."
+	ConnectedOrgConfigFilename = "Path to a JSON configuration file that defines connected orgs configurations. Note: Unsupported fields in the JSON file are ignored. To learn more about connected org configuration file format, see the request body in https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateconnectedorgconfig."
 	AuditFilter                = "JSON document that specifies which events to record. Escape any characters that may prevent parsing, such as single or double quotes, using a backslash (\\)."
 	InvitationFile             = "Path to an optional JSON configuration file that defines invitation settings. Note: Unsupported fields in the JSON file are ignored."
 	InitDB                     = "Flag that uses a folder to be mapped into LOCAL deployment for initialization"

tools/cmd/api-generator/string.go

@@ -109,11 +109,3 @@ func safeSlugify(value string) string {
 
 	return result
 }
-
-// ToURL creates a URL for the MongoDB Atlas API documentation based on a tag and operationId.
-// Both inputs are processed using safeSlugify before being inserted into the URL.
-func ToURL(tag, operationID string) string {
-	safeTag := safeSlugify(tag)
-	safeOperationID := safeSlugify(operationID)
-	return "https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/" + safeTag + "/operation/" + safeOperationID
-}