diff --git a/docs/README.md b/docs/README.md
index dc49ace9ad..15f9ef76fa 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -9,7 +9,7 @@ better yet, a pull request.
 - Overview
   - [What is Backstage?](overview/what-is-backstage.md)
   - [Backstage architecture](overview/architecture-overview.md)
-  - [Architect:ure and terminology](overview/architecture-terminology.md)
+  - [Architecture and terminology](overview/architecture-terminology.md)
   - [Roadmap](overview/roadmap.md)
 - Getting started
   - [Running Backstage locally](getting-started/index.md)
diff --git a/docs/dls/contributing-to-storybook.md b/docs/dls/contributing-to-storybook.md
index 6546073ef7..5c18eb3652 100644
--- a/docs/dls/contributing-to-storybook.md
+++ b/docs/dls/contributing-to-storybook.md
@@ -32,7 +32,7 @@ core
 Go to `packages/storybook`, run `yarn install` and install the dependencies,
 then run the following on your command line: `yarn start`
 
-![](assets/dls/running-storybook.png)
+![](../assets/dls/running-storybook.png)
 
 _You should see a log like the image above._
 
@@ -40,4 +40,4 @@ If everything worked out, your server will be running on **port 6006**, go to
 your browser and navigate to `http://localhost:6006/`. You should be able to
 navigate and see the Storybook page.
 
-![](assets/dls/storybook-page.png)
+![](../assets/dls/storybook-page.png)
diff --git a/docs/features/software-catalog/api.md b/docs/features/software-catalog/api.md
index fc1ae6e9ba..332c1e505b 100644
--- a/docs/features/software-catalog/api.md
+++ b/docs/features/software-catalog/api.md
@@ -2,3 +2,5 @@
 id: software-catalog-api
 title: API
 ---
+
+## TODO
diff --git a/docs/features/software-catalog/extending-the-model.md b/docs/features/software-catalog/extending-the-model.md
index 093a788741..7b3bc826cf 100644
--- a/docs/features/software-catalog/extending-the-model.md
+++ b/docs/features/software-catalog/extending-the-model.md
@@ -3,4 +3,4 @@ id: extending-the-model
 title: Extending the model
 ---
 
-TODO
+## TODO
diff --git a/docs/features/software-catalog/external-integrations.md b/docs/features/software-catalog/external-integrations.md
index 5f4df97940..fb8dc10c45 100644
--- a/docs/features/software-catalog/external-integrations.md
+++ b/docs/features/software-catalog/external-integrations.md
@@ -3,4 +3,4 @@ id: external-integrations
 title: External integrations
 ---
 
-TODO
+## TODO
diff --git a/docs/features/software-catalog/populating.md b/docs/features/software-catalog/populating.md
index 278f7af075..68c61f2822 100644
--- a/docs/features/software-catalog/populating.md
+++ b/docs/features/software-catalog/populating.md
@@ -2,3 +2,5 @@
 id: populating-catalog
 title: Populating the catalog
 ---
+
+## TODO
diff --git a/docs/features/software-catalog/system-model.md b/docs/features/software-catalog/system-model.md
index 7f134d4f48..b5a53080dc 100644
--- a/docs/features/software-catalog/system-model.md
+++ b/docs/features/software-catalog/system-model.md
@@ -3,4 +3,4 @@ id: system-model
 title: System Model
 ---
 
-TODO
+## TODO
diff --git a/docs/getting-started/development-environment.md b/docs/getting-started/development-environment.md
index d8890972ad..6a3a2cc7a2 100644
--- a/docs/getting-started/development-environment.md
+++ b/docs/getting-started/development-environment.md
@@ -3,8 +3,6 @@ id: development-environment
 title: Development Environment
 ---
 
-#
-
 This section describes how to get set up for doing development on the Backstage
 repository.