Merge pull request #1640 from spotify/alund/more-docs

[Docs] Fix broken links and more

docs/README.md

@@ -68,6 +68,7 @@ better yet, a pull request.
   - Designing for Backstage
     - [Backstage Design Language System (DLS)](dls/design.md)
     - [Storybook -- reusable UI components](dls/storybook.md)
+    - [Contributing to Storybook](dls/contributing-to-storybook.md)
     - [Figma resources](dls/figma.md)
   - API references
     - TypeScript API

docs/auth/index.md

@@ -25,8 +25,8 @@ as possible to create new plugins, and an auth solution based on user-to-server
 OAuth helps in that regard.
 
 The method with which frontend plugins request access to third party services is
-through [Utility APIs](../getting-started/utility-apis.md) for each service
-provider. For a full list of providers, see [TODO](#TODO).
+through [Utility APIs](../api/utility-apis.md) for each service provider. For a
+full list of providers, see [TODO](#TODO).
 
 ### Identity - WIP
 

docs/auth/oauth.md

@@ -8,7 +8,7 @@ to various third party APIs.
 
 There are occasions when the user wants to perform actions towards third party
 services that require authorization via OAuth. Backstage provides standardized
-[Utility APIs](../getting-started/utility-apis.md) such as the
+[Utility APIs](../api/utility-apis.md) such as the
 [GoogleAuthApi](../../packages/core-api/src/apis/definitions/auth.ts) for that
 use-case. Backstage also includes a set of implementations of these APIs that
 integrate with the [auth-backend](../../plugins/auth-backend) plugin to provide

docs/getting-started/index.md

@@ -62,8 +62,8 @@ collection of tutorials that will guide you through setting up and extending an
 instance of Backstage with your own plugins.
 
 - [Development Environment](development-environment.md)
-- [Create a Backstage Plugin](create-a-plugin.md)
-- [Structure of a Plugin](structure-of-a-plugin.md)
-- [Utility APIs](utility-apis.md)
+- [Create a Backstage Plugin](../plugins/create-a-plugin.md)
+- [Structure of a Plugin](../plugins/structure-of-a-plugin.md)
+- [Utility APIs](../api/utility-apis.md)
 
 [Back to Docs](../README.md)

mkdocs.yml

@@ -66,6 +66,7 @@ nav:
   - Designing for Backstage:
       - Backstage Design Language System (DLS): 'dls/design.md'
       - Storybook -- reusable UI components: 'dls/storybook.md'
+      - Contributing to Storybook: 'dls/contributing-to-storybook.md'
       - Figma resources: 'dls/figma.md'
   - API references:
       - TypeScript APIs: