From 89ecdf526a7d1183b7cc4956105be418c6371bcb Mon Sep 17 00:00:00 2001
From: Adam Harvey <adaharve@cisco.com>
Date: Wed, 14 Apr 2021 14:42:50 -0400
Subject: [PATCH] Update plugin example for composability

Signed-off-by: Adam Harvey <adaharve@cisco.com>
Signed-off-by: Brett Wright <wright.brett@gmail.com>
---
 .../configure-app-with-plugins.md             | 22 ++++++++++---------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/docs/getting-started/configure-app-with-plugins.md b/docs/getting-started/configure-app-with-plugins.md
index cdef932127..1753676e19 100644
--- a/docs/getting-started/configure-app-with-plugins.md
+++ b/docs/getting-started/configure-app-with-plugins.md
@@ -34,23 +34,25 @@ CircleCI is a frontend UI plugin, it goes in `app` rather than `backend`.
 export { plugin as Circleci } from '@backstage/plugin-circleci';
 ```
 
-3. Register the plugin router:
+3. Register the plugin in the entity pages:
 
 ```jsx
 // packages/app/src/components/catalog/EntityPage.tsx
-
-import { Router as CircleCIRouter } from '@backstage/plugin-circleci';
+import {
+  EntityCircleCIContent,
+  isCircleCIAvailable,
+} from '@backstage/plugin-circleci';
 
 // Then somewhere inside <EntityPageLayout>
-<EntityPageLayout.Content
-  path="/ci-cd/*"
-  title="CI/CD"
-  element={<CircleCIRouter />}
-/>;
+<EntitySwitch.Case if={isCircleCIAvailable}>
+  <EntityCircleCIContent />
+</EntitySwitch.Case>;
 ```
 
-Note that stand-alone plugins that are not "attached" to the Software Catalog
-would be added outside the `EntityPage`.
+This is just one example, but each Backstage instance may integrate content or
+cards to suit their needs on different pages, tabs, etc. Note that stand-alone
+plugins that are not "attached" to the Software Catalog would be added outside
+the `EntityPage`.
 
 4. [Optional] Add proxy config: