Address remaining docs review feedback

Clarify the remaining old frontend system sections, tighten the scaffolder follow-up wording, and rename the docs sidebar entry to match the frontend system terminology used elsewhere.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor

microsite/sidebars.ts

@@ -551,15 +551,15 @@ export default {
         ),
         sidebarElementWithIndex(
           {
-            label: 'New Frontend System',
-            description: 'New frontend system components and architecture.',
+            label: 'Frontend System',
+            description: 'Frontend system components and architecture.',
           },
           [
             'frontend-system/index',
             sidebarElementWithIndex(
               {
                 label: 'Architecture',
-                description: 'Architecture of the new frontend system.',
+                description: 'Architecture of the frontend system.',
                 differentiator: 'frontend-system/',
               },
               [

plugins/catalog-import/README.md

@@ -98,7 +98,11 @@ Following React components accept optional props for providing custom example en
 
 ## Old Frontend System
 
-If your Backstage app uses the old frontend system, add the `CatalogImportPage` extension to the app:
+If your Backstage app uses the old frontend system, you need to manually wire the
+plugin into your app as outlined in this section. If you are on the new frontend
+system, you can skip this.
+
+Add the `CatalogImportPage` extension to the app:
 
 ```tsx
 // packages/app/src/App.tsx

plugins/catalog-unprocessed-entities/README.md

@@ -47,7 +47,11 @@ app:
 
 ## Old Frontend System
 
-If your Backstage app uses the old frontend system, import into your `App.tsx` and include into the `<FlatRoutes>` component:
+If your Backstage app uses the old frontend system, you need to manually wire the
+plugin into your app as outlined in this section. If you are on the new frontend
+system, you can skip this.
+
+Import it into your `App.tsx` and include it in the `<FlatRoutes>` component:
 
 ```tsx title="packages/app/src/App.tsx"
 import { CatalogUnprocessedEntitiesPage } from '@backstage/plugin-catalog-unprocessed-entities';

plugins/mui-to-bui/README.md

@@ -21,7 +21,11 @@ Once installed, the plugin is automatically available in your app through the de
 
 ## Old Frontend System
 
-If your Backstage app uses the old frontend system, add a route for the page in your app:
+If your Backstage app uses the old frontend system, you need to manually wire the
+plugin into your app as outlined in this section. If you are on the new frontend
+system, you can skip this.
+
+Add a route for the page in your app:
 
 ```tsx
 // packages/app/src/App.tsx

plugins/scaffolder/README.md

@@ -25,9 +25,9 @@ Once installed, the plugin is automatically available in your app through the de
 ### Troubleshooting
 
 If you encounter [issues with early closure of the `EventStream`](https://github.com/backstage/backstage/issues/5535)
-which auto-updates logs during task execution, you can enable long polling. To do so,
-update your `packages/app/src/apis.ts` file to register a `ScaffolderClient` with the
-`useLongPollingLogs` set to `true`. By default, it is `false`.
+used to auto-update logs during task execution, you can work around them by enabling
+long polling. To do so, update your `packages/app/src/apis.ts` file to register a
+`ScaffolderClient` with `useLongPollingLogs` set to `true`. By default, it is `false`.
 
 ```typescript
 import {
@@ -74,7 +74,8 @@ to launch the plugin locally using the `createDevApp` of the `./dev/index.tsx` f
 
 To play with it, open a terminal and run the command: `yarn start` within the `./plugins/scaffolder` folder
 
-**NOTE:** Don't forget to open a second terminal and to launch the backend there, using `yarn start backend` and to specify the locations of the templates to play with!
+**NOTE:** Don't forget to open a second terminal, start your Backstage backend there,
+and configure the template locations that you want to test.
 
 ## Old Frontend System