-
Notifications
You must be signed in to change notification settings - Fork 8.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[DOCS] Improves Management section in docs #56669
Conversation
Pinging @elastic/kibana-docs (Team:Docs) |
run elasticsearch-ci/docs |
@@ -1,5 +1,5 @@ | |||
[[advanced-options]] | |||
== Setting advanced options | |||
== Advanced Settings |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Advanced Settings or Advanced settings?
@@ -1,30 +1,30 @@ | |||
[role="xpack"] | |||
[[index-lifecycle-policies]] | |||
== Index lifecycle policies | |||
== Index Lifecycle Policies |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why is it Index Lifecycle Policies in the title if it is index lifecycle policies on line 12?
@@ -1,32 +1,32 @@ | |||
[[managing-licenses]] | |||
== License management | |||
== License Management | |||
|
|||
When you install the default distribution of {kib}, you receive a basic license | |||
with no expiration date. For the full list of free features that are included in | |||
the basic license, see https://www.elastic.co/subscriptions[the subscription page]. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
see
or refer to
?
A rollup job is a periodic task that aggregates data from indices specified | ||
by an index pattern and rolls it into a new index. Rollup indices are a good way to | ||
compactly store months or years of historical | ||
A rollup job is a periodic task that aggregates data from indices specified |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How about:
A rollup job is a periodic task that aggregates data from indices specified by an index pattern, then rolls the data into a new index.
docs/user/management.asciidoc
Outdated
|
||
| <<data-rollups, *Rollup Jobs*>> | ||
|
||
Create a job that periodically aggregates data from one or more indices and |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How about:
Create a job that periodically aggregates data from one or more indices, then rolls the data into a new, compact index.
The fields for the index pattern are listed in a table. Click a column header to sort the table by that column. Click | ||
the *Controls* button in the rightmost column for a given field to edit the field's properties. You can manually set | ||
the field's format from the *Format* drop-down. Format options vary based on the field's type. | ||
The *Index patterns* UI in *Management* helps you create and manage |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Since we are already in the Management section, could this just say "The Index patterns UI ...."?
status of your license, start a trial, or install a new license. | ||
|
||
NOTE: You can start a trial only if your cluster has not already activated a | ||
trial license for the current major product version. For example, if you have | ||
already activated a trial for v6.0, you cannot start a new trial until | ||
already activated a trial for v6.0, you cannot start a new trial until |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
v6.0 or version 6.0 or 6.0?
|
||
{kib} *Management* provides user interfaces for working with data from remote | ||
clusters and managing the {ccr} process. You can replicate indices from a | ||
{kib} *Management* provides user interfaces for working with data from remote |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How about:
Work with data from remote clusters and manage the {ccr} process.
@@ -1,9 +1,9 @@ | |||
[[managing-saved-objects]] | |||
== Saved objects | |||
== Saved Objects | |||
|
|||
*Saved Objects* helps you keep track of and manage your saved objects. These objects |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Instead of starting all of these sections with "[Feature] helps you...", how about just starting with what the UI helps the user do? So for this one, it would be:
Keep track of and manage your saved objects.
{kib} makes it easy for you to create a rollup job by walking you through | ||
the process. You fill in the name, data flow, and how often you want to roll | ||
up the data. Then you define a date histogram aggregation for the rollup job | ||
and optionally terms, histogram, and metrics aggregations. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
and optionally define?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
@elasticmachine merge upstream |
* [DOCS] Improves Management section in docs * [DOCS] Fixes build error * [DOCS] Incorporates review comments in management docs
* [DOCS] Improves Management section in docs * [DOCS] Fixes build error * [DOCS] Incorporates review comments in management docs
* [DOCS] Improves Management section in docs * [DOCS] Fixes build error * [DOCS] Incorporates review comments in management docs
Summary
This PR:
[skip ci]
Preview:
http://kibana_56669.docs-preview.app.elstc.co/guide/en/kibana/master/management.html