Skip to content

[docs] Document connector known issues for recent fixes - #155643

Merged
Jan-Kazlouski-elastic merged 2 commits into
elastic:mainfrom
Jan-Kazlouski-elastic:docs/connectors-known-issues-gap-update
Aug 3, 2026
Merged

Jan-Kazlouski-elastic merged 2 commits into
elastic:mainfrom
Jan-Kazlouski-elastic:docs/connectors-known-issues-gap-update

Conversation

@Jan-Kazlouski-elastic

Copy link
Copy Markdown
Contributor

Summary

Adds Connector known-issues entries for product-facing fixes on elastic/connectors main since the last documented Outlook SSL cert-file race (elastic/connectors#4094 / #152570).

Each entry follows the existing known-issues format (symptom, Affected versions, Fix / Workaround where needed). Outlook SDH hardenings are separate bullets.

PR Connector Topic
#4085 Outlook Mailbox-less accounts / empty SSL cert abort sync
#4118 Confluence DC/Server space.permissions HTTP 500 / site-admin requirement
#4119 GitHub Swallowed fetch errors → empty “successful” syncs
#4123 Outlook Null Exchange fields abort sync
#4147 Outlook DistributionList in Contacts aborts sync
#4148 MongoDB Out-of-range BSON datetimes (opt-in DATETIME_CLAMP)
#4158 Outlook Unexpected item types / folder errors abort sync
#4287 Outlook Unrecognised EWS elements abort calendar sync
#4291 Outlook DLS identity prefix mismatch hides mailbox content
#4297 Confluence Inherited page restrictions over-granted under DLS
#4306 SharePoint Online SharePointHomeCacheList Unauthorized aborts sync

Shipped versions are based on the first release tag that contains each backport where available; otherwise the connectors branch VERSION / PR backport labels (for example 8.19.20, 9.3.9, 9.4.5).

Test plan

  • Docs-only change; entries match the style of existing Outlook / Jira known-issues bullets
  • Spot-check rendered page for es-connectors-known-issues after merge (or via docs preview)
  • Confirm backport/shipped in patch numbers against the next connectors releases if any label drifts

Made with Cursor

Add known-issues entries for Outlook, Confluence, GitHub,
MongoDB, and SharePoint Online fixes merged after the last
documented Outlook SSL race entry.

Co-authored-by: Cursor <cursoragent@cursor.com>
@elasticsearchmachine elasticsearchmachine added external-contributor Pull request authored by a developer outside the Elasticsearch team v9.6.0 labels Jul 31, 2026
@Jan-Kazlouski-elastic Jan-Kazlouski-elastic added the >docs General docs changes label Jul 31, 2026
@Jan-Kazlouski-elastic
Jan-Kazlouski-elastic requested a review from a team July 31, 2026 17:39
@github-actions

github-actions Bot commented Jul 31, 2026 •

Copy link
Copy Markdown
Contributor

🔍 Preview links for changed docs

@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs Style Checker (Vale)

Summary: 1 suggestion found

💡 Suggestions (1): Optional style improvements. Apply when helpful.
File Line Rule Message
docs/reference/search-connectors/es-connectors-known-issues.md 281 Elastic.WordChoice Consider using 'stop, cancel, end' instead of 'abort', unless the term is in the UI.

The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

@github-actions

Copy link
Copy Markdown
Contributor

ℹ️ Important: Docs version tagging

👋 Thanks for updating the docs! Just a friendly reminder that our docs are now cumulative. This means all 9.x versions are documented on the same page and published off of the main branch, instead of creating separate pages for each minor version.

We use applies_to tags to mark version-specific features and changes.

Expand for a quick overview

When to use applies_to tags:

✅ At the page level to indicate which products/deployments the content applies to (mandatory)
✅ When features change state (e.g. preview, ga) in a specific version
✅ When availability differs across deployments and environments

What NOT to do:

❌ Don't remove or replace information that applies to an older version
❌ Don't add new information that applies to a specific version without an applies_to tag
❌ Don't forget that applies_to tags can be used at the page, section, and inline level

🤔 Need help?

Correct elastic#4094 shipped/affected versions against connectors
tags, use 9.5.0 (not 9.5.1) while the 9.5 branch VERSION is
still 9.5.0, omit unmerged 8.19 for elastic#4291, and widen the
Confluence elastic#4118 lower bound to 8.7.0.

Co-authored-by: Cursor <cursoragent@cursor.com>
@Jan-Kazlouski-elastic
Jan-Kazlouski-elastic marked this pull request as ready for review July 31, 2026 17:57
@Jan-Kazlouski-elastic
Jan-Kazlouski-elastic requested a review from a team as a code owner July 31, 2026 17:57
@elasticsearchmachine elasticsearchmachine added the needs:triage Requires assignment of a team area label label Jul 31, 2026
@Jan-Kazlouski-elastic

Copy link
Copy Markdown
Contributor Author

@coderabbitai full review

@elasticsearchmachine elasticsearchmachine removed the needs:triage Requires assignment of a team area label label Jul 31, 2026
@elasticsearchmachine

Copy link
Copy Markdown
Collaborator

Pinging @elastic/search-extract-and-transform (Team:Search - Extract & Transform)

@Jan-Kazlouski-elastic
Jan-Kazlouski-elastic merged commit 8632bb0 into elastic:main Aug 3, 2026
13 checks passed
tballison pushed a commit to tballison/elasticsearch that referenced this pull request Aug 4, 2026
* Document connector known issues for recent fixes

Add known-issues entries for Outlook, Confluence, GitHub,
MongoDB, and SharePoint Online fixes merged after the last
documented Outlook SSL race entry.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Fix known-issues version mismatches from audit

Correct elastic#4094 shipped/affected versions against connectors
tags, use 9.5.0 (not 9.5.1) while the 9.5 branch VERSION is
still 9.5.0, omit unmerged 8.19 for elastic#4291, and widen the
Confluence elastic#4118 lower bound to 8.7.0.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
tveasey pushed a commit to tveasey/elasticsearch that referenced this pull request Aug 6, 2026
* Document connector known issues for recent fixes

Add known-issues entries for Outlook, Confluence, GitHub,
MongoDB, and SharePoint Online fixes merged after the last
documented Outlook SSL race entry.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Fix known-issues version mismatches from audit

Correct elastic#4094 shipped/affected versions against connectors
tags, use 9.5.0 (not 9.5.1) while the 9.5 branch VERSION is
still 9.5.0, omit unmerged 8.19 for elastic#4291, and widen the
Confluence elastic#4118 lower bound to 8.7.0.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes external-contributor Pull request authored by a developer outside the Elasticsearch team :SearchOrg/Extract&Transform Label for the Search E&T team Team:Search - Extract & Transform v9.6.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants