Skip to content

Conversation

@Gerry-Forde
Copy link
Member

@Gerry-Forde Gerry-Forde commented Nov 29, 2024

RHIDP-4768 - Plugins should be able to know on which Backstage they are running on.

IMPORTANT: Do Not Merge - To be merged by Docs Team Only

Version(s):
1.4

Add the relevant labels to the Pull Request.
Issue:
RHIDP-4801

@rhdh-bot
Copy link
Collaborator

rhdh-bot commented Nov 29, 2024

[id="proc-identifying-backstage-flavor-for-plugins_{context}"]
= Identifying Backstage flavor for plugins

You can use the `developerHub.flavor` field to identify whether plugins are running on {product-very-short}, RHTAP, or vanilla Backstage, as shown in the following example:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So ideally this information is for customers who are creating plugins for their RHDH instance and need to know whether their plugin is running on RHDH, RHTAP, or vanilla Backstage. So, this would be something that is referenced only from within a plugin and would have no impact to RHDH. And should only be updated by a platform engineer if they are running anything other than RHDH.

To me this would make the most sense in docs that involve writing plugins for RHDH as just a highlight of how to determine what platform the plugin is currently installed to. But I don't believe that we have anything like that at the moment.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@PatAKnight I see your point and I also struggled a bit to decide where this content should appear in our existing documentation.

We don't have any docs about writing plugins, so perhaps we could include it in the Configuring Dynamic Plugins guide which is intended for platform engineers to enable/configure plugins.

@hmanwani-rh @Preeticp Any thoughts? When we disassemble the Admin Guide, will we still have a Configure category, if so, what will be included in that category?

Copy link
Member Author

@Gerry-Forde Gerry-Forde Dec 12, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@PatAKnight Having discussed this with the Docs team (considering we don't have any creating plugins documentation), for this release, we think it best to place this content in the RNs.

c.c. @jmagak

@Gerry-Forde Gerry-Forde changed the title RHIDP-4768 - Plugins should be able to know on which Backstage they are running on. RHIDP-4801 - Plugins should be able to know on which Backstage they are running on. Dec 10, 2024
@Gerry-Forde
Copy link
Member Author

Closing as this content has been moved to the RNs for RHDH 1.4

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants