salesforce: Update documentation and field descriptions

[shmsr]

Proposed commit message

Improve and update the documentation as per the latest Salesforce release. This PR also improves field descriptions.

Summary of changes:

• Fix grammar and ensure consistent casing
• Use backticks consistently (no asterisks)
• Update content to be latest
• Add authentication mechanisms section and also fix sub headings
• Fix minor bugs
• Improve field descriptions for clarity
• Restructure with better headings/sub-headings
• Add more Salesforce official links related to auth, deprecation notice, change in steps, etc.
• Documentation now follows the new documentation guidelines

Checklist

• I have reviewed tips for building integrations and this pull request is aligned with them.
• I have verified that all data streams collect metrics or logs.
• I have added an entry to my package's changelog.yml file.
• I have verified that Kibana version constraints are current according to guidelines.
• I have verified that any added dashboard complies with Kibana's Dashboard good practices

[Copilot]

Pull Request Overview

This PR updates the Salesforce integration documentation to reflect the latest Winter '26 (v65.0) release and improves field descriptions throughout the package. The changes modernize authentication guidance and enhance clarity for users.

Key changes:

• Updated compatibility information from Spring '22/Summer '24 to Winter '26 (v65.0)
• Enhanced authentication documentation with clearer JWT bearer and Username-Password flow instructions
• Improved field descriptions across data streams for better clarity and consistency

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/salesforce/docs/README.md	Updated version compatibility, enhanced authentication methods documentation, improved field descriptions
packages/salesforce/_dev/build/docs/README.md	Mirror of main README updates for build documentation
packages/salesforce/data_stream/setupaudittrail/manifest.yml	Improved configuration field descriptions
packages/salesforce/data_stream/setupaudittrail/fields/fields.yml	Enhanced field descriptions for better clarity
packages/salesforce/data_stream/logout/manifest.yml	Improved configuration field descriptions
packages/salesforce/data_stream/logout/fields/fields.yml	Enhanced field descriptions and corrected terminology
packages/salesforce/data_stream/login/manifest.yml	Improved configuration field descriptions
packages/salesforce/data_stream/login/fields/fields.yml	Enhanced field descriptions for consistency
packages/salesforce/data_stream/apex/manifest.yml	Improved configuration field descriptions

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated no new comments.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Linu-Elias]

I think the section heading should be What do I need to use this integration? as mentioned in the documentation guidelines

[shmsr]

Thanks. Updated the docs to follow these new guidelines. Updated other sections as well.

[elasticmachine]

💔 Build Failed

• Buildkite Build
• Commit: bf368aa

Failed CI Steps

• Check integrations salesforce

History

• 💔 Build #32480 failed 3739121
• 💔 Build #32463 failed fe9753c

cc @shmsr

[Copilot]

Pull Request Overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated no new comments.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[alaudazzi]

@shmsr the new structure looks good 👍