Merge branch 'master' into mobile-sidebar

Signed-off-by: Philipp Hugenroth <philipph@spotify.com>

docs/api/utility-apis.md

@@ -199,7 +199,7 @@ export a class that `implements` the target API, for example:
 
 ```ts
 export class IgnoringErrorApi implements ErrorApi {
-  post(error: Error, context?: ErrorContext) {
+  post(error: ErrorApiError, context?: ErrorApiErrorContext) {
     // ignore error
   }
 }

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

@@ -144,7 +144,8 @@ spec:
 
 Note that to be able to read from targets that are outside of the normal
 integration points such as `github.com`, you'll need to explicitly allow it by
-adding an entry in the `backend.reading.allow` list. For example:
+adding an entry in the `backend.reading.allow` list. Paths can be specified to
+further restrict targets For example:
 
 ```yml
 backend:
@@ -153,6 +154,8 @@ backend:
     allow:
       - host: example.com
       - host: '*.examples.org'
+      - host: example.net
+        paths: ['/api/']
 ```
 
 ## Common to All Kinds: The Envelope

docs/features/techdocs/configuration.md

@@ -106,6 +106,12 @@ techdocs:
       # This allows providers like LocalStack, Minio and Wasabi (and possibly others) to be used to host tech docs.
       s3ForcePathStyle: false
 
+      # (Optional) AWS Server Side Encryption
+      # Defaults to undefined.
+      # If not set, encrypted buckets will fail to publish.
+      # https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-s3-encryption.html
+      sse: 'aws:kms' # or AES256
+
     # Required when techdocs.publisher.type is set to 'azureBlobStorage'. Skip otherwise.
 
     azureBlobStorage:

docs/local-dev/cli-commands.md

@@ -41,6 +41,7 @@ lint                     Lint a package
 test                     Run tests, forwarding args to Jest, defaulting to watch mode
 clean                    Delete cache directories
 
+create                   Open up an interactive guide to creating new things in your app
 create-plugin            Creates a new plugin in the current repository
 remove-plugin            Removes plugin in the current repository
 
@@ -277,6 +278,44 @@ Options:
   -h, --help       display help for command
 ```
 
+## create
+
+Scope: `root`
+
+The `create` command opens up an interactive guide for you to create new things
+in your app. If you do not pass in any options it is completely interactive, but
+it is possible to pre-select what you want to create using the `--select` flag,
+and provide options using `--options`, for example:
+
+```bash
+backstage-cli create --select plugin --option id=foo
+```
+
+This command is typically added as script in the root `package.json` to be
+executed with `yarn backstage-create`, using options that are appropriate for
+the organization that owns the app repo. For example you may have it set up like
+this:
+
+```json
+{
+  "scripts": {
+    "backstage-create": "backstage-cli create --scope internal --no-private --npm-registry https://acme.org/npm"
+  }
+}
+```
+
+```text
+Usage: backstage-cli create [options]
+
+Options:
+  --select <name>          Select the thing you want to be creating upfront
+  --option <name>=<value>  Pre-fill options for the creation process (default: [])
+  --scope <scope>          The scope to use for new packages
+  --npm-registry <URL>     The package registry to use for new packages
+  --no-private             Do not mark new packages as private
+  -h, --help               display help for command
+```
+
 ## create-plugin
 
 Scope: `root`