Merge pull request #15338 from backstage/docs/update

doc updates, replay of #14797

docs/auth/auth0/provider.md

@@ -37,6 +37,8 @@ auth:
         audience: ${AUTH_AUTH0_AUDIENCE}
         connection: ${AUTH_AUTH0_CONNECTION}
         connectionScope: ${AUTH_AUTH0_CONNECTION_SCOPE}
+  session:
+    secret: ${AUTH_SESSION_SECRET}
 ```
 
 The Auth0 provider is a structure with three configuration keys:
@@ -46,6 +48,8 @@ The Auth0 provider is a structure with three configuration keys:
   page
 - `domain`: The Application domain, found on the Auth0 Application page
 
+Because Auth0 requires a session you need to give the session a secret key.
+
 ## Optional Configuration
 
 - `audience`: The intended recipients of the token

docs/features/software-catalog/descriptor-format.md

@@ -1309,3 +1309,7 @@ resolved relative to the location of this Location entity itself.
 A list of targets as strings. They can all be either absolute paths/URLs
 (depending on the type), or relative paths such as `./details/catalog-info.yaml`
 which are resolved relative to the location of this Location entity itself.
+
+### `spec.presence` [optional]
+
+Describes whether the target of a location is required to exist or not. It defaults to `'required'` if not specified, can also be `'optional'`.