Add descriptions to table.csv and update link texts

[charlotte-hoblik]

This PR adds descriptions to the links in table.csv.

As a result, the links in the documentation will not show up as "External documantation" anymore; but as meaningful descriptions of where the link is pointing to.

(Generative AI was used to generate the link descriptions.)

Connected to: elastic/docs-content#5277

Preview

Before

After

[leemthompo]

One general comment, let's try to avoid any truncated link text like this:

[kosabogi]

I'm not sure if refining the link texts and making them more consistent is within the scope of this PR. If not, please feel free to ignore this comment (and a lot of my suggestions).

I think we could generally use two different patterns depending on the type of page the link points to:

• If the link points to a more conceptual or descriptive page, we could use phrasing like Learn more about [concept].
  For example:
  https://www.elastic.co/docs/reference/text-analysis/character-filter-reference → Learn more about character filtering

• If the link points to an API page, it might be clearer to explicitly reference the API name in the link text.

  For example, for the following API page:
  https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-segments

  A link text like Learn more about index segments could be misleading, because it sounds like it would lead to a conceptual description rather than an API reference page.

[kosabogi]

Suggested change

	anthropic-max-tokens,https://docs.claude.com/en/api/messages#body-max-tokens,[use-doc-url],,Learn more about messages - Claude API Reference
	anthropic-max-tokens,https://docs.claude.com/en/api/messages#body-max-tokens,[use-doc-url],,Learn more about messages - Claude API reference

[kosabogi]

Suggested change

	anthropic-messages,https://docs.anthropic.com/en/api/messages,[use-doc-url],,Learn more about messages - Claude API Reference
	anthropic-messages,https://docs.anthropic.com/en/api/messages,[use-doc-url],,Learn more about messages - Claude API reference

[kosabogi]

Suggested change

	anthropic-models,https://docs.anthropic.com/en/docs/about-claude/models/all-models#model-names,[use-doc-url],,Learn more about Models overview - Claude API Docs
	anthropic-models,https://docs.anthropic.com/en/docs/about-claude/models/all-models#model-names,[use-doc-url],,Learn more about models - Claude API reference

[kosabogi]

Suggested change

	clean-up-snapshot-repo,https://www.elastic.co/docs/deploy-manage/tools/snapshot-and-restore/self-managed#snapshots-repository-cleanup,[use-doc-url],,Learn more about managing snapshot repositories in self-managed
	clean-up-snapshot-repo,https://www.elastic.co/docs/deploy-manage/tools/snapshot-and-restore/self-managed#snapshots-repository-cleanup,[use-doc-url],,Learn more about managing snapshot repositories in self-managed deployments

[kosabogi]

Suggested change

	cluster-get-settings,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-get-settings,,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/cluster-get-settings.html,Learn more abou cluster-wide settings
	cluster-get-settings,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-get-settings,,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/cluster-get-settings.html,Learn more about cluster-wide settings

[kosabogi]

Suggested change

	indices-reload-analyzers,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-reload-search-analyzers,,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-reload-analyzers.html,Learn more about Reload search analyzers
	indices-reload-analyzers,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-reload-search-analyzers,,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-reload-analyzers.html,Learn more about the Reload search analyzers API

[kosabogi]

Suggested change

	indices-resolve-cluster-api,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster,,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-resolve-cluster-api.html,Learn more about Resolve the cluster
	indices-resolve-cluster-api,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster,,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-resolve-cluster-api.html,Learn more about the Resolve the cluster API

[kosabogi]

Suggested change

	indices-resolve-index-api,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-index,https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-indices-resolve-index,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-resolve-index-api.html,Learn more about Resolve indices
	indices-resolve-index-api,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-index,https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-indices-resolve-index,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-resolve-index-api.html,Learn more about the Resolve indices API

[kosabogi]

Suggested change

	indices-rollover-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-rollover,https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-indices-rollover,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-rollover-index.html,Learn more about Roll over to a new index
	indices-rollover-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-rollover,https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-indices-rollover,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-rollover-index.html,Learn more about the Roll over to a new index API

[kosabogi]

Suggested change

	analysis-charfilters,https://www.elastic.co/docs/reference/text-analysis/character-filter-reference,[use-doc-url],,Learn more about character filter reference
	analysis-charfilters,https://www.elastic.co/docs/reference/text-analysis/character-filter-reference,[use-doc-url],,Learn more about character filtering

[kosabogi]

I'm not sure if refining the link texts and making them more consistent is within the scope of this PR. If not, please feel free to ignore this comment (and a lot of my suggestions).

I think we could generally use two different patterns depending on the type of page the link points to:

• If the link points to a more conceptual or descriptive page, we could use phrasing like Learn more about [concept].
  For example:
  https://www.elastic.co/docs/reference/text-analysis/character-filter-reference → Learn more about character filtering

• If the link points to an API page, it might be clearer to explicitly reference the API name in the link text.

  For example, for the following API page:
  https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-segments

  A link text like Learn more about index segments could be misleading, because it sounds like it would lead to a conceptual description rather than an API reference page.

[charlotte-hoblik]

Thanks so much for the detailed review, @kosabogi! I’ve fixed the typos you caught and rewrote the link descriptions to ensure they fit within the strict 33-character limit to avoid the truncation @leemthompo pointed out.

You are absolutely right about using consistent patterns. It was a bit tricky to apply them strictly given the tight character limit, but I did my best to establish a fallback hierarchy to keep things as consistent as possible. Here is what I used:

• “Learn more about [X]” (when X is ≤13 characters)
• “More about [X]” (when it fits within 33 characters)
• “About [X]” (for the tightest limits)
• “Creating or updating [object]” (for create/update actions, e.g., alias, lifecycle policy, GeoIP database)

Let me know what you think of the updated texts!

[kosabogi]

I reviewed it up to line 150. In some places, sentences are cut off. I marked these with comments, but it might be worth running another round with AI and reviewing them again.

[kosabogi]

It looks like something important got cut off here (possibly “AWS”?).
If this was due to a character limit, we could rephrase it as either:

• “About managing access keys” (if the surrounding context makes it clear), or
• “Managing AWS access keys” (clearer and more explicit).

[kosabogi]

Same as above

[kosabogi]

Same as above

[kosabogi]

"Analytics" got cut off here

[kosabogi]

"pattern" got cut off here

[kosabogi]

something got cut off here

[kosabogi]

something got cut off here