From aa58c01e2cc08c3ca26ec3e87088f8ac5935e31e Mon Sep 17 00:00:00 2001
From: Adam Harvey <adam.harvey@dxc.com>
Date: Thu, 11 Feb 2021 22:29:53 -0500
Subject: [PATCH] Add changeset

Signed-off-by: Adam Harvey <adam.harvey@dxc.com>
---
 .changeset/perfect-coats-train.md | 60 +++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 .changeset/perfect-coats-train.md

diff --git a/.changeset/perfect-coats-train.md b/.changeset/perfect-coats-train.md
new file mode 100644
index 0000000000..a8c62d6264
--- /dev/null
+++ b/.changeset/perfect-coats-train.md
@@ -0,0 +1,60 @@
+---
+'@backstage/plugin-catalog': patch
+---
+
+Adds a new `SystemDiagram` component to mvisually map all elements in a system.
+
+To use this new component, a new system entity page would need to be added to the `packages/app/src/components/catalog/EntityPage.tsx` file.
+
+For example,
+
+```tsx
+const SystemOverviewContent = ({ entity }: { entity: Entity }) => (
+  <Grid container spacing={3}>
+    <Grid item xs={12} md={4}>
+      <AboutCard entity={entity} variant="gridItem" />
+    </Grid>
+    <Grid item xs={12} md={8}>
+      <SystemDiagram entity={entity} />
+    </Grid>
+  </Grid>
+);
+
+const SystemEntityPage = ({ entity }: { entity: Entity }) => (
+  <EntityPageLayout>
+    <EntityPageLayout.Content
+      path="/*"
+      title="Overview"
+      element={<SystemOverviewContent entity={entity} />}
+    />
+    <EntityPageLayout.Content
+      path="/docs/*"
+      title="Docs"
+      element={<DocsRouter entity={entity} />}
+    />
+  </EntityPageLayout>
+);
+```
+
+And the addition of a new switch case to the `EntityPage`:
+
+```diff
+-export const EntityPage = () => {
+-  const { entity } = useEntity();
+-
+-  switch (entity?.kind?.toLowerCase()) {
+-    case 'component':
+-      return <ComponentEntityPage entity={entity} />;
+-    case 'api':
+-      return <ApiEntityPage entity={entity} />;
+-    case 'group':
+-      return <GroupEntityPage entity={entity} />;
+-    case 'user':
+-      return <UserEntityPage entity={entity} />;
++    case 'system':
++      return <SystemEntityPage entity={entity} />;
+-    default:
+-      return <DefaultEntityPage entity={entity} />;
+-  }
+-};
+```