Merge branch 'rugvip/mod' into rugvip/migraine

docs/overview/glossary.md

@@ -11,7 +11,7 @@ terminology below for clarity and consistency when discussing Backstage.
 
 ### Authentication Glossary
 
-This [page](./auth/glossary.md) directs to the terms and phrases related to
+This [page](../auth/glossary.md) directs to the terms and phrases related to
 authentication and identity section of Backstage.
 
 ### Backstage User Profiles

docs/plugins/create-a-plugin.md

@@ -22,9 +22,9 @@ yarn create-plugin
 This will create a new Backstage Plugin based on the ID that was provided. It
 will be built and added to the Backstage App automatically.
 
-> If `yarn start` is already running you should be able to see the default page
-> for your new plugin directly by navigating to
-> `http://localhost:3000/my-plugin`.
+> If the Backstage App is already running (with `yarn start` or `yarn dev`) you
+> should be able to see the default page for your new plugin directly by
+> navigating to `http://localhost:3000/my-plugin`.
 
 ![](../assets/my-plugin_screenshot.png)
 
@@ -32,7 +32,7 @@ You can also serve the plugin in isolation by running `yarn start` in the plugin
 directory. Or by using the yarn workspace command, for example:
 
 ```bash
-yarn workspace @backstage/plugin-welcome start # Also supports --check
+yarn workspace @backstage/my-plugin start # Also supports --check
 ```
 
 This method of serving the plugin provides quicker iteration speed and a faster

docs/prettier.config.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2020 Spotify AB
+ * Copyright 2020 The Backstage Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

docs/tutorials/configuring-plugin-databases.md

@@ -36,7 +36,7 @@ Please ensure the appropriate database drivers are installed in your `backend`
 package. If you intend to use both `postgres` and `sqlite3`, you can install
 both of them.
 
-```shell
+```sh
 cd packages/backend
 
 # install pg if you need postgres
@@ -184,4 +184,21 @@ configuration do not have permissions to create databases, you must ensure they
 exist before starting the service. The service will not be able to create them,
 it can only use them.
 
-Good luck!
+### Privileges
+
+As Backstage attempts to check if the database exists, you may need to grant
+privileges to list or show databases for a given user. For PostgreSQL, you would
+grant the following:
+
+```postgres
+GRANT SELECT ON pg_database TO some_user;
+```
+
+MySQL:
+
+```mysql
+GRANT SHOW DATABASES ON *.* TO some_user;
+```
+
+The mechanisms in this guide should help you tackle different database
+deployment situations. Good luck!