Skip to content

Commit d756cd6

Browse files
authored
[DOCS] Reformat release highlights as What's new. (#58074)
* [DOCS] Reformat release highlights as What's new. * Removed line break.
1 parent 961a85e commit d756cd6

File tree

4 files changed

+41
-24
lines changed

4 files changed

+41
-24
lines changed

docs/reference/index.asciidoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ include::../Versions.asciidoc[]
1212

1313
include::intro.asciidoc[]
1414

15+
include::release-notes/highlights.asciidoc[]
16+
1517
include::getting-started.asciidoc[]
1618

1719
include::setup.asciidoc[]
@@ -72,8 +74,6 @@ include::glossary.asciidoc[]
7274

7375
include::rest-api/index.asciidoc[]
7476

75-
include::release-notes/highlights.asciidoc[]
76-
7777
include::migration/index.asciidoc[]
7878

7979
include::release-notes.asciidoc[]

docs/reference/intro.asciidoc

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
11
[[elasticsearch-intro]]
2-
= Elasticsearch introduction
3-
[partintro]
4-
--
2+
== What is {es}?
53
_**You know, for search (and analysis)**_
64

75
{es} is the distributed search and analytics engine at the heart of
@@ -35,10 +33,9 @@ We’re continually amazed by the novel ways people use search. But whether
3533
your use case is similar to one of these, or you're using {es} to tackle a new
3634
problem, the way you work with your data, documents, and indices in {es} is
3735
the same.
38-
--
3936

4037
[[documents-indices]]
41-
== Data in: documents and indices
38+
=== Data in: documents and indices
4239

4340
{es} is a distributed document store. Instead of storing information as rows of
4441
columnar data, {es} stores complex data structures that have been serialized
@@ -91,7 +88,7 @@ used at search time. When you query a full-text field, the query text undergoes
9188
the same analysis before the terms are looked up in the index.
9289

9390
[[search-analyze]]
94-
== Information out: search and analyze
91+
=== Information out: search and analyze
9592

9693
While you can use {es} as a document store and retrieve documents and their
9794
metadata, the real power comes from being able to easily access the full suite
@@ -107,7 +104,7 @@ or Ruby.
107104

108105
[float]
109106
[[search-data]]
110-
=== Searching your data
107+
==== Searching your data
111108

112109
The {es} REST APIs support structured queries, full text queries, and complex
113110
queries that combine the two. Structured queries are
@@ -132,7 +129,7 @@ third-party applications to interact with {es} via SQL.
132129

133130
[float]
134131
[[analyze-data]]
135-
=== Analyzing your data
132+
==== Analyzing your data
136133

137134
{es} aggregations enable you to build complex summaries of your data and gain
138135
insight into key metrics, patterns, and trends. Instead of just finding the
@@ -164,7 +161,7 @@ embroidery_ needles.
164161

165162
[float]
166163
[[more-features]]
167-
==== But wait, there’s more
164+
===== But wait, there’s more
168165

169166
Want to automate the analysis of your time-series data? You can use
170167
{ml-docs}/ml-overview.html[machine learning] features to create accurate
@@ -179,7 +176,7 @@ And the best part? You can do this without having to specify algorithms, models,
179176
or other data science-related configurations.
180177

181178
[[scalability]]
182-
== Scalability and resilience: clusters, nodes, and shards
179+
=== Scalability and resilience: clusters, nodes, and shards
183180
++++
184181
<titleabbrev>Scalability and resilience</titleabbrev>
185182
++++
@@ -211,7 +208,7 @@ interrupting indexing or query operations.
211208

212209
[float]
213210
[[it-depends]]
214-
=== It depends...
211+
==== It depends...
215212

216213
There are a number of performance considerations and trade offs with respect
217214
to shard size and the number of primary shards configured for an index. The more
@@ -239,7 +236,7 @@ testing with your own data and queries].
239236

240237
[float]
241238
[[disaster-ccr]]
242-
=== In case of disaster
239+
==== In case of disaster
243240

244241
For performance reasons, the nodes within a cluster need to be on the same
245242
network. Balancing shards in a cluster across nodes in different data centers
@@ -259,7 +256,7 @@ secondary clusters are read-only followers.
259256

260257
[float]
261258
[[admin]]
262-
=== Care and feeding
259+
==== Care and feeding
263260

264261
As with any enterprise system, you need tools to secure, manage, and
265262
monitor your {es} clusters. Security, monitoring, and administrative features

docs/reference/release-notes/8.0.0-alpha1.asciidoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
[[release-notes-8.0.0-alpha1]]
22
== {es} version 8.0.0-alpha1
33

4+
coming[8.0.0]
5+
46
The changes listed below have been released for the first time in {es}
57
8.0.0-alpha1.
68

@@ -25,4 +27,4 @@ all we need to do is to set `index.indexing.slowlog.threshold.index.debug` and
2527
`index.indexing.slowlog.threshold.index.trace` to `-1` {pull}57591[#57591]
2628

2729

28-
coming[8.0.0]
30+
Lines changed: 26 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,31 @@
11
[[release-highlights]]
2-
= Release highlights
2+
== What's new in {minor-version}
33

4-
[partintro]
5-
--
6-
This section summarizes the most important changes in each release. For the
7-
full list, see <<es-release-notes>> and <<breaking-changes>>.
4+
coming[{minor-version}]
85

9-
* <<release-highlights-8.0.0>>
6+
Here are the highlights of what's new and improved in {es} {minor-version}!
7+
ifeval::["{release-state}"!="unreleased"]
8+
For detailed information about this release, see the
9+
<<release-notes-{elasticsearch_version}, Release notes >> and
10+
<<breaking-changes-{minor-version}, Breaking changes>>.
11+
endif::[]
1012

11-
--
13+
// Add previous release to the list
14+
// Other versions:
15+
// {ref-bare}/7.last/release-highlights.html[7.last]
16+
// | {ref-bare}/8.0/release-highlights.html[8.0]
1217

13-
include::highlights-8.0.0.asciidoc[]
18+
// Use the notable-highlights tag to mark entries that
19+
// should be featured in the Stack Installation and Upgrade Guide:
20+
// tag::notable-highlights[]
21+
// [discrete]
22+
// === Heading
23+
//
24+
// Description.
25+
// end::notable-highlights[]
26+
27+
// Omit the notable highlights tag for entries that only need to appear in the ES ref:
28+
// [float]
29+
// === Heading
30+
//
31+
// Description.

0 commit comments

Comments
 (0)