elastic / elastic/docs-content

Remote clusters: ECE -> ECK referencing steps of a procedure of another doc

Open
#4,102 1 comment 1 reaction 0 assignees View on GitHub
Team:Admin
Dominant language
No language data
Stars
47
Forks
261
Avg merge
3d 12h
Merged PRs (30d)
116

Description

Affected document: https://www.elastic.co/docs/deploy-manage/remote-clusters/ece-enable-ccs-for-eck

This approach is not ideal:

Image

The equivalent doc of [Remote Clusters from ECH to ECK ](https://www.elastic.co/docs/deploy-manage/remote-clusters/ec-enable-ccs-for-eck) doesn't face this issue as we recently updated it.

We should write a clear and valid procedure instead of linking to N steps of another do that could eventually change.

Consider using snippets if the procedures of both pages are really equivalent or similar.

---

## Elastic Docs AI Scoping 🤖

Docs issue scope

### Summary
The issue asks to fix `ece-enable-ccs-for-eck.md`, which currently cross-references steps from a different document (`ece-remote-cluster-self-managed.md`) in its TLS certificate procedure, rather than providing a self-contained how-to. There are no linked code PRs because this is a pure documentation quality improvement; the scope was confirmed directly by reading the source files. The equivalent ECH→ECK page (`ec-enable-ccs-for-eck.md`) was already fixed and serves as the model.

### Request accuracy
Accurate — the file at `deploy-manage/remote-clusters/ece-enable-ccs-for-eck.md` (line 102, TLS certificate tab) tells users to "Follow the steps provided in [Access clusters of a self-managed environment](ece-remote-cluster-self-managed.md), and specifically the first three steps..." instead of providing those steps inline.

### Next action for author
Rewrite the "Establish trust in the ECE cluster" section in the TLS certificate (deprecated) tab of `ece-enable-ccs-for-eck.md` to be self-contained, mirroring the structure of `ec-enable-ccs-for-eck.md`.

### Impact: High

### Scope boundary
The API key tab and all non-TLS-certificate sections of this page do not need changes; the `ece-remote-cluster-self-managed.md` page itself does not need changes.

### Recommended documentation targets

| Page | URL | Action | Impact | Confidence | Why this page? |
|------|-----|--------|--------|------------|----------------|
| Connect ECE deployments to ECK clusters | https://www.elastic.co/docs/deploy-manage/remote-clusters/ece-enable-ccs-for-eck | Update existing page | High | High | This is the broken page — the cross-reference in the TLS tab needs to be replaced with a self-contained procedure. |

### Recommendations

1. **Rewrite** the "Establish trust in the ECE cluster" section in the TLS certificate (deprecated) tab of `ece-enable-ccs-for-eck.md`. Replace the sentence that defers to `ece-remote-cluster-self-managed.md` with numbered sub-steps equivalent to those in the ECH page (`ec-enable-ccs-for-eck.md`, lines 95–122), adapted for the ECE UI (e.g., ECE Security page path, correct Scope ID `default.es.local`, ECE trust settings UI).

2. **Consider adding** a "Update the downloaded `trust.yml` file for ECK compatibility" section (as exists in `ec-enable-ccs-for-eck.md`, lines 124–162) if the same `trust.yml` subject-name correction is required for ECE-issued certificates.

3. **Evaluate snippets** — if the ECE and ECH procedures for the ECK-side trust configuration (kubectl steps, YAML spec) are identical, extract them into a new shared snippet in `_snippets/` and include it from both pages. The page already uses this pattern extensively.

### Notes

- The page is a how-to; all additions should stay in that form (numbered steps, concrete commands, no conceptual digressions).
- The TLS certificate tab is already marked `(deprecated)` — keep that label and limit changes to accuracy; no need to expand this tab's scope.
- Follow-on assembly work is minimal: no new pages, redirects, or nav changes needed.

> Generated by [Issue Scope Analyzer](https://github.com/elastic/docs-content/actions/runs/27815407575) for issue #4102 · 117.2 AIC · ⌖ 18 AIC · ⊞ 29.3K · [◷](https://github.com/search?q=repo%3Aelastic%2Fdocs-content+is%3Aissue+%22gh-aw-workflow-call-id%3A+elastic%2Fdocs-content%2Fgh-aw-docs-issue-scope%22&type=issues)

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.