Skip to content

Reorganization and first content refinements content#5088

Merged
kosabogi merged 16 commits intoreference_arch_genaifrom
bogi-clean-up
Feb 12, 2026
Merged

Reorganization and first content refinements content#5088
kosabogi merged 16 commits intoreference_arch_genaifrom
bogi-clean-up

Conversation

@kosabogi
Copy link
Contributor

This PR focuses on cleaning up and reorganizing the GenAI search high availability reference architecture.

What was done

  • Added a new Vector search optimization section
  • Reorganized the content to present use cases first, followed by vector search optimization, and then the architecture section
  • Organized considerations sections into a new Important considerations section to be more concise and less wordy with headings
  • Added links to related documentation pages
  • Moved and reframed a paragraph to improve narrative flow: "Promoting the multi–availability zone..." description to serve as the introduction of the Architecture section
  • Applied substitutions and minor language cleanup

Some additional language and style cleanup is still needed, along with more links to relevant documentation and resources.

@kosabogi kosabogi requested a review from eedugon February 10, 2026 17:20
@kosabogi kosabogi requested a review from a team as a code owner February 10, 2026 17:20
@github-actions
Copy link
Contributor

github-actions bot commented Feb 10, 2026

Vale Linting Results

Summary: 4 warnings, 1 suggestion found

⚠️ Warnings (4)
File Line Rule Message
deploy-manage/reference-architectures/genai-search-high-availability.md 26 Elastic.DontUse Don't use 'and/or'.
deploy-manage/reference-architectures/genai-search-high-availability.md 39 Elastic.DontUse Don't use 'very'.
deploy-manage/reference-architectures/genai-search-high-availability.md 58 Elastic.DontUse Don't use 'very'.
deploy-manage/reference-architectures/genai-search-high-availability.md 128 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'vs'.
💡 Suggestions (1)
File Line Rule Message
deploy-manage/reference-architectures/genai-search-high-availability.md 67 Elastic.Wordiness Consider using 'also' instead of 'In addition'.

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.

Copy link
Contributor

@eedugon eedugon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like a lot the changes, shared some comments.

One thing to consider in the Important consideratoins structure is if we like more the OTP that was before:

Image

vs the new OTP

Image

IMO we are losing interesting navigation on the right bar with this new approach. Just to double check.

kosabogi and others added 3 commits February 11, 2026 16:49
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
kosabogi and others added 11 commits February 12, 2026 09:34
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
…bility.md

Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com>
Copy link
Contributor

@eedugon eedugon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@kosabogi kosabogi merged commit 0cdf8d1 into reference_arch_genai Feb 12, 2026
7 checks passed
@kosabogi kosabogi deleted the bogi-clean-up branch February 12, 2026 09:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants