Skip to content

Commit 34715f4

Browse files
marciwflobernd
authored andcommitted
[DOCS] Spruce up the Introduction (#8372)
1 parent 0e0492c commit 34715f4

File tree

1 file changed

+18
-20
lines changed

1 file changed

+18
-20
lines changed

Diff for: docs/intro.asciidoc

+18-20
Original file line numberDiff line numberDiff line change
@@ -5,52 +5,50 @@
55

66
*Rapidly develop applications with the .NET client for {es}.*
77

8-
Designed for .NET client-application developers, you can utilize the .NET language client
9-
library, which provides a strongly-typed API and query DSL to interact with {es}.
10-
The .NET client library is designed to make it easy to use {es} from your .NET
11-
applications. The .NET client includes higher-level abstractions, such as
8+
Designed for .NET application developers, the .NET language client
9+
library provides a strongly typed API and query DSL for interacting with {es}.
10+
The .NET client includes higher-level abstractions, such as
1211
helpers for coordinating bulk indexing and update operations. It also comes with
1312
built-in, configurable cluster failover retry mechanisms.
1413

1514
The {es} .NET client is available as a https://www.nuget.org/packages/Elastic.Clients.Elasticsearch[NuGet]
16-
package that can be used in .NET Core, .NET 5+ and .NET Framework (4.6.1 and higher)
15+
package for use with .NET Core, .NET 5+, and .NET Framework (4.6.1 and later)
1716
applications.
1817

19-
_NOTE: This documentation relates to the v8 .NET client for {es}, designed for use
20-
with {es} 8.x versions. To develop applications targetting {es} v7, you should
21-
use the https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17[v7 (NEST) client]._
18+
_NOTE: This documentation covers the v8 .NET client for {es}, for use
19+
with {es} 8.x versions. To develop applications targeting {es} v7, use the
20+
https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17[v7 (NEST) client]._
2221

2322
[discrete]
2423
[[features]]
2524
=== Features
2625

27-
* One-to-one mapping with REST API.
26+
* One-to-one mapping with the REST API.
2827
* Strongly typed requests and responses for {es} APIs.
2928
* Fluent API for building requests.
3029
* Query DSL to assist with constructing search queries.
3130
* Helpers for common tasks such as bulk indexing of documents.
32-
* Pluggable serialization of requests and responses based on System.Text.Json.
31+
* Pluggable serialization of requests and responses based on `System.Text.Json`.
3332
* Diagnostics, auditing, and .NET activity integration.
3433

35-
The .NET {es} client is built upon the Elastic Transport library which provides:
34+
The .NET {es} client is built on the Elastic Transport library, which provides:
3635

3736
* Connection management and load balancing across all available nodes.
3837
* Request retries and dead connections handling.
3938

4039
[discrete]
4140
=== {es} version compatibility
4241

43-
Language clients are forward compatible; meaning that clients support communicating
44-
with greater or equal minor versions of {es}. {es} language clients are only
45-
backwards compatible with default distributions and without guarantees made.
42+
Language clients are forward compatible: clients support communicating
43+
with current and later minor versions of {es}. {es} language clients are
44+
backward compatible with default distributions only and without guarantees.
4645

4746
[discrete]
4847
=== Questions, bugs, comments, feature requests
4948

50-
Bug reports and feature requests are more than welcome on the
51-
{github}/issues[github issues pages]!
49+
To submit a bug report or feature request, use
50+
{github}/issues[GitHub issues].
5251

53-
For more general questions and comments, we monitor questions and discussions
54-
opened on our community forum, https://discuss.elastic.co/c/elasticsearch[discuss.elastic.co].
55-
Mentioning `.NET` in the title helps folks quickly identify what
56-
the question is about.
52+
For more general questions and comments, try the community forum
53+
on https://discuss.elastic.co/c/elasticsearch[discuss.elastic.co].
54+
Mention `.NET` in the title to indicate the discussion topic.

0 commit comments

Comments
 (0)