RHIDP-6566: Rename Create with Self-service #1077
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
hmanwani-rh
force-pushed
the
RHIDP-6566-main
branch
from
29feeb8 to
4475ed9
Compare
christoph-jerolimov
approved these changes
Apr 17, 2025
linfraze
reviewed
Apr 18, 2025
Comment on lines
+24
to
+25
| . Browse the list of groups shown on the page. | ||
| . Select a group to view the information imported from Keycloak. |
There was a problem hiding this comment.
You can combine these into a single step or maybe replace with something like the following:
Suggested change
| . Browse the list of groups shown on the page. | |
| . Select a group to view the information imported from Keycloak. | |
| . From the list of groups, select a group to view the information imported from Keycloak. |
|
|
||
| image::rhdh-plugins-reference/group1.jpg[group-profile] | ||
| .Procedure | ||
| . Go to the *Catalog* page. |
There was a problem hiding this comment.
It can be helpful to orient the user so they know where to start. From where do they go to the Catalog page? Do we mean something like From the {product} home page or In the {product} navigation menu, click Catalog?
| @@ -6,7 +6,7 @@ | |||
| As an administrator, you can configure the {product} global header to create a consistent and flexible navigation bar across your {product-short} instance. | |||
| By default, the {product-short} global header includes the following components: | |||
|
|
|||
| * *Create* button provides quick access to a variety of templates, enabling users to efficiently set up services, backend and front-end plugins within {product-short} | |||
| * *Self-service* button provides quick access to a variety of templates, enabling users to efficiently set up services, backend and front-end plugins within {product-short} | |||
There was a problem hiding this comment.
The change to Self-service looks good but wondering if we should use back end or back-end. IBM says to only use backend when referring to a specific product or thing in Python.
There was a problem hiding this comment.
I would expect we have a glossar, but my opinion on this is: frontend and backend, no space, no dash.
| @@ -2,7 +2,7 @@ | |||
| = Customizing your {product} global header | |||
|
|
|||
| You can use the `red-hat-developer-hub.backstage-plugin-global-header` dynamic plugin to extend the global header with additional buttons and customize the order and position of icons and features. Additionally, you can create and integrate your custom dynamic header plugins using the mount points provided by this new header feature, allowing you to further tailor to suit your needs. | |||
| For more information on enabling dynamic plugins, see link:{installing-and-viewing-dynamic-plugins-url}[{installing-and-viewing-dynamic-plugins-title}]. | |||
| For more information on enabling dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. | |||
There was a problem hiding this comment.
Suggested change
| For more information on enabling dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. | |
| For more information about enabling dynamic plugins, see link:{installing-and-viewing-plugins-book-url}[{installing-and-viewing-plugins-book-title}]. |
I recall one of the style guides saying to use about in place of on in this context
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
IMPORTANT: Do Not Merge - To be merged by Docs Team Only
Version(s):
1.6
Issue:
RHIDP-6566
Preview:
https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-1077/customizing/
https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-1077/plugins-rhdh-using/#importing-users-and-groups-in-developer-hub-using-the-keycloak-plugin