W-18282485 Cursor suggestions for short descriptions (POC)

[hannanelson]

Writer's Quality Checklist

Before merging your PR, did you:

• Run spell checker
• Run link checker to check for broken xrefs
• Check for orphan files
• Perform a local build and do a final visual check of your content, including checking for:
  • Broken images
  • Dead links
  • Correct rendering of partials if they are used in your content
  • Formatting issues, such as:
    • Misnumbered ordered lists (steps) or incorrectly nested unordered lists
    • Messed up tables
    • Proper indentation
    • Correct header levels
• Receive final review and signoff from:
  • Technical SME
  • Product Manager
  • Editor or peer reviewer
  • Reporter, if this content is in response to a reported issue (internal or external feedback)
• If applicable, verify that the software actually got released

[hannanelson]

I used this prompt with Cursor and the gemini-2.5-pro-exp-03-25 model

Check all .adoc files in the pages folder to see if the short description (paragraph after the H1 heading) follows these guidelines:

• Each short description should be at least 2 to 4 sentences that summarize the topic and build on the title without repeating it.
  -Put the most relevant language and keywords in the first 155 characters.
  -Summarize the key information in the topic
• Use active voice
• Highlight the customer benefit or user's main job.
  -Use simple, concise, declarative sentences.
  -Avoid self-referential phrases like "This topic describes..."
  -Don’t introduce a list or an image, and don’t use “these” or “the following".

[valkyrie69]

We don't want to spell out RPA like in the original?

[valkyrie69]

Nice!

[valkyrie69]

Suggested change

	Control the integration between your Anypoint Platform and Salesforce organizations by managing specific capabilities. After establishing a trusted connection, selectively enable or disable features like Einstein Activity Capture or Invocable Actions based on your business needs. This ensures you only expose the necessary functionality for the integration.
	Control the integration between your Anypoint Platform and Salesforce organizations by managing specific capabilities. After establishing a trusted connection, selectively enable or disable features like Einstein or Invocable Actions based on your business needs.

[valkyrie69]

Suggested change

Maintain the connections between your Anypoint Platform organization and trusted Salesforce organizations. As an administrator, learn how to enable newly established tenant relationships to activate cross-platform features. You can also repair connections if Salesforce domain details change, edit the displayed Salesforce organization name for clarity, or permanently remove connections when they are no longer needed.

Maintain the connections between your Anypoint Platform organization and trusted Salesforce organizations. Enable newly established tenant relationships to activate cross-platform features. You can also repair connections if Salesforce domain details change, edit the displayed Salesforce organization name for clarity, or permanently remove connections when they are no longer needed.

[valkyrie69]

Suggested change

	Control user access across Anypoint Platform by understanding and managing permissions effectively. Assign appropriate capabilities through roles (deprecated) or the recommended Teams feature to regulate access to specific products, APIs, environments, and business groups. Properly configured permissions ensure users have the necessary access while maintaining security and compliance.
	Control user access across Anypoint Platform by understanding and managing permissions effectively. Assign appropriate capabilities through the Teams feature to regulate access to specific products, APIs, environments, and business groups. Properly configured permissions ensure users have the necessary access while maintaining security and compliance.

[valkyrie69]

Suggested change

Prepare for a successful single sign-on (SSO) implementation by understanding the necessary prerequisites and potential limitations within Anypoint Platform. Ensure your identity provider (IdP) is correctly configured to send required user attributes and handle signed/encrypted SAML assertions. Be aware of specific client behaviors and limitations related to session timeouts, external identity scope, and user management when using SSO.

Prepare for a successful single sign-on (SSO) implementation by understanding the necessary prerequisites and potential limitations within Anypoint Platform. Ensure your identity provider (IdP) is correctly configured to send required user attributes and handle signed and encrypted SAML assertions. Be aware of specific client behaviors and limitations related to session timeouts, external identity scope, and user management when using SSO.

[valkyrie69]

Suggested change

	Understand how to structure teams effectively using a practical example. See how a hypothetical organization, Acme, uses a main Engineering team with specialized Identity and DevOps sub-teams to manage permissions efficiently. This hierarchical approach helps delegate access based on specific roles and responsibilities.
	See how a hypothetical organization, Acme, uses a main Engineering team with specialized Identity and DevOps sub-teams to manage permissions and structure teams effectively in this practical example. This hierarchical approach helps delegate access based on specific roles and responsibilities.

[valkyrie69]

Suggested change

	Troubleshoot single sign-on (SSO) issues by capturing the SAML response directly within your web browser. Perform an SSO login attempt and then use your browser's developer tools to inspect the network traffic. This allows you to find and analyze the SAML assertion details, which is essential for diagnosing configuration problems or providing information to support.
	Troubleshoot single sign-on (SSO) issues by capturing the SAML response directly within your web browser. Attempt an SSO login and then use your browser's developer tools to inspect the network traffic. This allows you to find and analyze the SAML assertion details, which is essential for diagnosing configuration problems or providing information to support.

[valkyrie69]

Spell out RPA?
Is it okay to use words like "powerful" and "seamless?" I don't mind, but writer.ai usually raps my knuckles.

[valkyrie69]

Suggested change

	Manage user accounts within your Anypoint Platform root organization as an administrator. Learn how to invite new users, enable or disable existing accounts, and assign or revoke permissions individually or through teams/roles. Understand the implications of deleting users and how to manage pending invitations or reset user passwords.
	Manage user accounts within your Anypoint Platform root organization as an administrator. Learn how to invite new users, enable or disable existing accounts, and assign or revoke permissions individually or through teams. Understand the implications of deleting users and how to manage pending invitations or reset user passwords.