Create article scope

[klizhentas]

Problem

We have tried multiple approaches to fix tailor navigation structure, including changing navigation in different scopes. This has proved to be confusing, because people have to constantly switch back and forth between scopes just to see the article.

Hiding navigation items or changing structure is bad for search indexing and discovery.

Instead we should keep the navigation structure static, but have a very explicit label in the top header area that highlights the n, please create a scopes part in the header that works like Gitlab:

---
title: Application Access Role-Based Access Control
description: Role-Based Access Control (RBAC) for Teleport Application Access.
scopes: oss, enterprise, cloud
---

Here is how title should look like approximately:

Supported scope and description:

scope: oss, enterprise
The title should render on-hover "Available in OSS and Enterprise editions"

Special case is all, renders as: ALL

scope: all
The title should render on-hover "Available in OSS, Enterprise, Cloud editions"

[ptgott]

I think this would be great, and have some thoughts:

1. I think we should also indicate in the navigation sidebar that a page only applies to a particular edition. This way, a user won't need to navigate to a page to realize that it doesn't apply to their use-case. One way we could do this is below (just to illustrate what I mean). This will reduce the space we have in the nav bar for text, so we can think of alternatives as well.

2. The banner indicating which edition a page supports should be as clear as possible, since some users may be arriving at the docs site without knowing that we have three editions. The majority of users already ignore the scope dropdown menu, so we should minimize the risk that users ignore this banner as well.

[klizhentas]

@ptgott we can try this, but because there are a lot of nav sections like that, we should make it more subtle, a small gray label will be better.

[ulysseskan]

Banner blindness may be keeping people from looking at our header and missing the edition selector on top.

To increase visibility, how about listing all sections for all editions neatly in the left navbar (perhaps also increasing contrast and making the sidebar wider), but adding bold text "This feature is only available in the Enterprise edition." as a one-line 2nd paragraph of the article near the top of the page - in the same font as the article.

[klizhentas]

@ulysseskan good point. I think we can try a simple solution to this problem by making a header to be a more regular header. @Alqanar can you try the style above to see if it works better.

[Alqanar]

@klizhentas I would like to clarify.

1. What we do with header?

• header with the grey gradient:

• header with the white background:

• header with extra line, where we specify scope

• initial version from the issue, but with white background

2. Do we make any changes to the navigation? Something like that?

[klizhentas]

@Alqanar header with white background with extra line, where we specify scope looks great, let's try this one

[klizhentas]

@Alqanar re: icons, let's try those, but move the icons in front of the text