Merge remote-tracking branch 'origin/master' into blam/break-up-scaffolder

* origin/master: (55 commits)
  backend-app-api: switch plugin log label pluginId->plugin
  backend-app-api: create a labelled logger for rootHttpRouter
  backend-app-api: remove startHttpServer
  fix(deps): update dependency @rjsf/utils to v5.0.0-beta.16
  backend-app-api: fix infinite loop in http server stop
  remove autoformatting changes
  remove dev file
  use index for key in react fragment
  Minor grammar fix to CONTRIBUTING.md
  backend-app-api: explicit request handler types for MiddlewareFactory
  added changesets for the root API refactor and move from backend-common
  backend-app-api: update API report + fixes
  add highlighting of legend item
  docs(docs/features/software-templates/writing-custom-field-extensions.md): change "kehab" to "kebab".
  backend-app-api: move http dir out of lib
  backend-common: reimplement service builder using backend-app-api
  backend-app-api: move cors and helmet options reader to http folder
  address review comments
  fix picky cli-report
  fix logic
  ...

Signed-off-by: blam <ben@blam.sh>

plugins/scaffolder-react/api-report.md

@@ -28,6 +28,23 @@ import { TemplateEntityV1beta3 } from '@backstage/plugin-scaffolder-common';
 import { UIOptionsType } from '@rjsf/utils';
 import { UiSchema } from '@rjsf/utils';
 
+// @public
+export type Action = {
+  id: string;
+  description?: string;
+  schema?: {
+    input?: JSONSchema7;
+    output?: JSONSchema7;
+  };
+  examples?: ActionExample[];
+};
+
+// @public
+export type ActionExample = {
+  description: string;
+  example: string;
+};
+
 // @alpha
 export const createFieldValidation: () => FieldValidation_2;
 
@@ -102,14 +119,7 @@ export type FormProps = Pick<
 >;
 
 // @public
-export type ListActionsResponse = Array<{
-  id: string;
-  description?: string;
-  schema?: {
-    input?: JSONSchema7;
-    output?: JSONSchema7;
-  };
-}>;
+export type ListActionsResponse = Array<Action>;
 
 // @public
 export type LogEvent = {

plugins/scaffolder-react/src/api/types.ts

@@ -44,18 +44,36 @@ export type ScaffolderTask = {
 };
 
 /**
- * The response shape for the `listActions` call to the `scaffolder-backend`
+ * A single action example
  *
  * @public
  */
-export type ListActionsResponse = Array<{
+export type ActionExample = {
+  description: string;
+  example: string;
+};
+
+/**
+ * The response shape for a single action in the `listActions` call to the `scaffolder-backend`
+ *
+ * @public
+ */
+export type Action = {
   id: string;
   description?: string;
   schema?: {
     input?: JSONSchema7;
     output?: JSONSchema7;
   };
-}>;
+  examples?: ActionExample[];
+};
+
+/**
+ * The response shape for the `listActions` call to the `scaffolder-backend`
+ *
+ * @public
+ */
+export type ListActionsResponse = Array<Action>;
 
 /** @public */
 export type ScaffolderOutputLink = {