Skip to content

docs: rewrite README for open-source clarity#36

Merged
marevol merged 1 commit into
mainfrom
docs/oss-friendly-readme
Jul 9, 2026
Merged

docs: rewrite README for open-source clarity#36
marevol merged 1 commit into
mainfrom
docs/oss-friendly-readme

Conversation

@marevol

@marevol marevol commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Remove decorative emoji from section headings and trim marketing-style language
  • Consolidate configuration and usage examples that were previously duplicated across three sections (Quick Start, Configuration, Advanced Configuration)
  • Fix two sample code snippets that no longer matched the current dependency versions: a CurlRequest#url() call that does not exist, and TotalHits#value field access, which is now the record accessor value() in the Lucene version bundled with OpenSearch 3.7.0
  • Add a table listing the OpenSearch/Elasticsearch versions actually exercised by the integration test suite
  • Simplify the architecture section into a short description of the actual classes instead of a list of design-pattern names

Test plan

  • Verified TotalHits.value() and CreateIndexResponse.index() signatures against the opensearch-3.7.0/lucene-core-10.4.0 jars
  • Verified CurlRequest#header(String, String) and HttpClient#addRequestBuilder(UnaryOperator<CurlRequest>) against the curl4j sources
  • No functional code changes; documentation only

Remove decorative emoji headings, trim marketing language, and
consolidate duplicated configuration/usage examples. Fix a couple of
sample snippets that no longer matched the current dependency
versions (a nonexistent CurlRequest#url() call, and TotalHits#value
being a record accessor rather than a field in the bundled Lucene
version). Add a table of the OpenSearch/Elasticsearch versions
actually covered by the integration test suite.
@marevol marevol merged commit 77616fb into main Jul 9, 2026
1 check passed
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.

1 participant