From f8b0468a0363588a40d07c8e6dd96d4a517b9a3f Mon Sep 17 00:00:00 2001 From: shainaraskas Date: Wed, 12 Feb 2025 10:04:11 -0500 Subject: [PATCH 1/6] more --- .../_snippets/content-patterns-list.md | 2 +- docs/versions/content-patterns.md | 51 +++++++++++++++---- 2 files changed, 42 insertions(+), 11 deletions(-) diff --git a/docs/versions/_snippets/content-patterns-list.md b/docs/versions/_snippets/content-patterns-list.md index 3a01f0841..993cb332b 100644 --- a/docs/versions/_snippets/content-patterns-list.md +++ b/docs/versions/_snippets/content-patterns-list.md @@ -4,7 +4,7 @@ | [Section/heading-level `applies` tags](/versions/content-patterns.md#sectionheading-level-applies-tags) | Provide signals about a section’s scope so a user can choose to read or skip it as needed. | | [Tabs](/versions/content-patterns.md#tabs) | Provide two sets of procedures when one or more steps in a process differs between contexts or versions. | | [Callouts](/versions/content-patterns.md#callouts) | Draw attention to happy differences and basic clarifications. | -| [Prose](/versions/content-patterns.md#prose) | Provide clarifying or secondary information, explain differences with a "why". | +| [Prose](/versions/content-patterns.md#prose) | - Identify features in a **list of features** that are exclusive to a specific context, or that were introduced in a specific version
- List differing requirements, limits, and other simple, mirrored facts
- Provide clarifying or secondary information
- Explain differences with a "why" (e.g. comparative overviews) | | [Sibling pages](/versions/content-patterns.md#sibling-pages) | When the information is too complex to be addressed with only the other content patterns. See specific examples in the sibling pages section. | % | [List item suffixes](/versions/content-patterns.md#list-item-suffixes) | Identify features in a **list of features** that are exclusive to a specific context, or that were introduced in a specific version. | diff --git a/docs/versions/content-patterns.md b/docs/versions/content-patterns.md index a7462321f..09fc5a82e 100644 --- a/docs/versions/content-patterns.md +++ b/docs/versions/content-patterns.md @@ -211,9 +211,11 @@ If there’s a terminology change or other minor change (especially where x equa **Use case**: Clarifying or secondary information, differences with a "why" **When to use:** +* When features in a list of features are exclusive to a specific context, or were introduced in a specific version +* Requirements, limits, other simple, mirrored facts * Cases where the information isn’t wildly important, but nice to know, or to add basic terminology change info to overviews * Comparative overviews -* Differences that are small enough or not significant enough to warrant an admonition or tabs or separate sections with frontmatter. +* Differences that are small enough or not significant enough to warrant an admonition or tabs or separate sections with front matter In some cases, you might want to add a paragraph specific to one version or another in prose to clarify behavior or terminology. @@ -223,12 +225,45 @@ In cases where there are significant differences between contexts, close explana ### Examples -* In {{stack}} 9.1.0 and earlier, **Spaces** were referred to as **Places**. ::::{tab-set} -:group: one-two-three +:group: one-three-four-five-six -:::{tab-item} One +:::{tab-item} Unique features +:sync: five + +* Each space has its own saved objects. +* Users can only access the spaces that they have been granted access to. This access is based on user roles, and a given role can have different permissions per space. +* In {{stack}} 9.0.0+, each space has its own navigation. + +::: +:::: + +:::{tab-item} Unique reqs / limits +:sync: six + +* In serverless, use `Admin` or equivalent +* In {{stack}} 9.0.0+, use `kibana_admin` or equivalent + +OR + +The maximum number of spaces that you can have differs by [what do we call this]: + +* In serverless, you can have a maximum of 100 spaces. +* In {{stack}} 9.0.0+, the maximum is controlled by the `xpack.spaces.maxSpaces` setting. Default is 1000. +::: + +:::{tab-item} Nice-to-know +:sync: four + +In {{stack}} 9.1.0 and earlier, **Spaces** were referred to as **Places**. + +OR + +If you're managing a {{stack}} v9 deployment, then you can also assign roles and define permissions for a space from the **Permissions** tab of the space settings. +::: + +:::{tab-item} Comparative overviews :sync: one The way that TLS certificates are managed depends on your deployment type: @@ -240,12 +275,7 @@ In {{eck}}, you can manage certificates for the HTTP layer. Certificates for the In {{ece}}, you can use one or more proxy certificates to secure the HTTP layer. These certificates are managed at the ECE installation level. Transport-level encryption is managed by ECE and certificates can’t be changed. ::: -:::{tab-item} Two -:sync: two -If you're managing a {{stack}} v9 deployment, then you can also assign roles and define permissions for a space from the **Permissions** tab of the space settings. -::: - -:::{tab-item} Three +:::{tab-item} Comparative overviews II :sync: three **Managed security in Elastic Cloud** @@ -264,6 +294,7 @@ You can augment Elastic Cloud security features in the following ways: ::: :::: + ## Sibling pages **Use case:** From 63b19c756370b39224de89880e7422438299b0b1 Mon Sep 17 00:00:00 2001 From: shainaraskas Date: Wed, 12 Feb 2025 10:07:54 -0500 Subject: [PATCH 2/6] unbold --- docs/versions/_snippets/content-patterns-list.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/versions/_snippets/content-patterns-list.md b/docs/versions/_snippets/content-patterns-list.md index 993cb332b..4157477bb 100644 --- a/docs/versions/_snippets/content-patterns-list.md +++ b/docs/versions/_snippets/content-patterns-list.md @@ -4,7 +4,7 @@ | [Section/heading-level `applies` tags](/versions/content-patterns.md#sectionheading-level-applies-tags) | Provide signals about a section’s scope so a user can choose to read or skip it as needed. | | [Tabs](/versions/content-patterns.md#tabs) | Provide two sets of procedures when one or more steps in a process differs between contexts or versions. | | [Callouts](/versions/content-patterns.md#callouts) | Draw attention to happy differences and basic clarifications. | -| [Prose](/versions/content-patterns.md#prose) | - Identify features in a **list of features** that are exclusive to a specific context, or that were introduced in a specific version
- List differing requirements, limits, and other simple, mirrored facts
- Provide clarifying or secondary information
- Explain differences with a "why" (e.g. comparative overviews) | +| [Prose](/versions/content-patterns.md#prose) | - Identify features in a list of features that are exclusive to a specific context, or that were introduced in a specific version
- List differing requirements, limits, and other simple, mirrored facts
- Provide clarifying or secondary information
- Explain differences with a "why" (e.g. comparative overviews) | | [Sibling pages](/versions/content-patterns.md#sibling-pages) | When the information is too complex to be addressed with only the other content patterns. See specific examples in the sibling pages section. | % | [List item suffixes](/versions/content-patterns.md#list-item-suffixes) | Identify features in a **list of features** that are exclusive to a specific context, or that were introduced in a specific version. | From 0dd3595784d105a37006573ebb729fc61b63c469 Mon Sep 17 00:00:00 2001 From: shainaraskas Date: Wed, 12 Feb 2025 10:08:34 -0500 Subject: [PATCH 3/6] clarity' --- docs/versions/content-patterns.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/versions/content-patterns.md b/docs/versions/content-patterns.md index 09fc5a82e..6efe341aa 100644 --- a/docs/versions/content-patterns.md +++ b/docs/versions/content-patterns.md @@ -208,9 +208,7 @@ If there’s a terminology change or other minor change (especially where x equa ## Prose -**Use case**: Clarifying or secondary information, differences with a "why" - -**When to use:** +**Use case:** * When features in a list of features are exclusive to a specific context, or were introduced in a specific version * Requirements, limits, other simple, mirrored facts * Cases where the information isn’t wildly important, but nice to know, or to add basic terminology change info to overviews From 5b92e274bbd87c7abff98fc0f72f7c89a7eb1664 Mon Sep 17 00:00:00 2001 From: shainaraskas Date: Wed, 12 Feb 2025 10:09:20 -0500 Subject: [PATCH 4/6] broken tabs --- docs/versions/content-patterns.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/versions/content-patterns.md b/docs/versions/content-patterns.md index 6efe341aa..5499f0232 100644 --- a/docs/versions/content-patterns.md +++ b/docs/versions/content-patterns.md @@ -225,7 +225,7 @@ In cases where there are significant differences between contexts, close explana ::::{tab-set} -:group: one-three-four-five-six +:group: five-six-four-one-three :::{tab-item} Unique features :sync: five From 5f6f764f141e3b7f533c03bf47defd1ed86bd2ba Mon Sep 17 00:00:00 2001 From: shainaraskas Date: Wed, 12 Feb 2025 10:12:26 -0500 Subject: [PATCH 5/6] oops --- docs/versions/content-patterns.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/versions/content-patterns.md b/docs/versions/content-patterns.md index 5499f0232..19af31c74 100644 --- a/docs/versions/content-patterns.md +++ b/docs/versions/content-patterns.md @@ -235,7 +235,6 @@ In cases where there are significant differences between contexts, close explana * In {{stack}} 9.0.0+, each space has its own navigation. ::: -:::: :::{tab-item} Unique reqs / limits :sync: six From dd856ab059aafa14011c3b3c8b2684915435270e Mon Sep 17 00:00:00 2001 From: shainaraskas <58563081+shainaraskas@users.noreply.github.com> Date: Wed, 12 Feb 2025 10:15:46 -0500 Subject: [PATCH 6/6] Update docs/versions/content-patterns.md --- docs/versions/content-patterns.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/versions/content-patterns.md b/docs/versions/content-patterns.md index 19af31c74..a0bbb08cd 100644 --- a/docs/versions/content-patterns.md +++ b/docs/versions/content-patterns.md @@ -208,7 +208,7 @@ If there’s a terminology change or other minor change (especially where x equa ## Prose -**Use case:** +**Use cases:** * When features in a list of features are exclusive to a specific context, or were introduced in a specific version * Requirements, limits, other simple, mirrored facts * Cases where the information isn’t wildly important, but nice to know, or to add basic terminology change info to overviews