Merge branch 'master' of github.com:spotify/backstage into shmidt-i/links-docs

docs/getting-started/development-environment.md

@@ -1,16 +1,28 @@
 # Development Environment
 
+This section describes how to get set up for doing development on the Backstage repository.
+
+## Cloning the Repository
+
+After you have cloned the Backstage repository, you should run the following commands
+once to set things up for development:
+
+```bash
+$ yarn install  # fetch dependency packages - may take a while
+
+$ yarn tsc      # does a first run of type generation and checks
+```
+
 ## Serving the Example App
 
-Open a terminal window and start the web app using the following commands from the project root:
+Open a terminal window and start the web app by using the following command from the project root.
+Make sure you have run the above mentioned commands first.
 
 ```bash
-$ yarn install # may take a while
-
 $ yarn start
 ```
 
-The final `yarn start` command should open a local instance of Backstage in your browser, otherwise open one of the URLs printed in the terminal.
+This should open a local instance of Backstage in your browser, otherwise open one of the URLs printed in the terminal.
 
 By default, backstage will start on port 3000, however you can override this by setting an environment variable `PORT` on your local machine. e.g. `export PORT=8080` then running `yarn start`. Or `PORT=8080 yarn start`.
 

docs/getting-started/structure-of-a-plugin.md

@@ -48,12 +48,12 @@ import ExampleComponent from './components/ExampleComponent';
 
 export const rootRouteRef = createRouteRef({
   icon: () => null,
-  path: '/{{ id }}',
-  title: '{{ id }}',
+  path: '/new-plugin',
+  title: 'New plugin',
 });
 
 export const plugin = createPlugin({
-  id: '{{ id }}',
+  id: 'new-plugin',
   register({ router }) {
     router.addRoute(rootRouteRef, ExampleComponent);
   },