diff --git a/docs/features/software-catalog/configuration.md b/docs/features/software-catalog/configuration.md
index 1afdff418a..b184bc85de 100644
--- a/docs/features/software-catalog/configuration.md
+++ b/docs/features/software-catalog/configuration.md
@@ -111,8 +111,7 @@ catalog:
 > deleting entities will not work in this mode.**
 
 A common use case for this configuration is when organizations have a remote
-source that should be mirrored into backstage. If we want backstage to be a
-mirror of this remote source we cannot allow users to also register entities
-with e.g.
+source that should be mirrored into Backstage. To make Backstage a mirror of
+this remote source, users cannot also register new entities with e.g. the
 [catalog-import](https://github.com/backstage/backstage/tree/master/plugins/catalog-import)
 plugin.
diff --git a/docs/features/software-templates/installation.md b/docs/features/software-templates/installation.md
index 96eea3c750..c682ca6ddf 100644
--- a/docs/features/software-templates/installation.md
+++ b/docs/features/software-templates/installation.md
@@ -262,6 +262,6 @@ library. By default it will use the
 [spotify/backstage-cookiecutter](https://github.com/backstage/backstage/blob/37e35b910afc7d1270855aed0ec4718aba366c91/plugins/scaffolder-backend/scripts/Cookiecutter.dockerfile)
 docker image.
 
-If you are running backstage from a Docker container and you want to avoid
+If you are running Backstage from a Docker container and you want to avoid
 calling a container inside a container, you can set up Cookiecutter in your own
 image, this will use the local installation instead.
diff --git a/docs/getting-started/app-custom-theme.md b/docs/getting-started/app-custom-theme.md
index 181f541929..4dbc6bfa48 100644
--- a/docs/getting-started/app-custom-theme.md
+++ b/docs/getting-started/app-custom-theme.md
@@ -135,3 +135,31 @@ const themeOptions = createThemeOptions({
   },
 });
 ```
+
+## Custom Logo
+
+In addition to a custom theme, you can also customize the logo displayed at the
+far top left of the site.
+
+In your frontend app, locate `src/components/Root/` folder. You'll find two
+components:
+
+- `LogoFull.tsx` - A larger logo used when the Sidebar navigation is opened.
+- `LogoIcon.tsx` - A smaller logo used when the sidebar navigation is closed.
+
+To replace the images, you can simply replace the relevant code in those
+components with raw SVG definitions.
+
+You can also use another web image format such as PNG by importing it. To do
+this, place your new image into a new subdirectory such as
+`src/components/Root/logo/my-company-logo.png`, and then add this code:
+
+```jsx
+import MyCustomLogoFull from './logo/my-company-logo.png';
+
+//...
+
+const LogoFull = () => {
+  return <img src={MyCustomLogoFull} />;
+};
+```
diff --git a/microsite/README.md b/microsite/README.md
index 9589def3e3..285622f1f8 100644
--- a/microsite/README.md
+++ b/microsite/README.md
@@ -1,3 +1,9 @@
+# Backstage Documentation
+
+This folder holds the service and configuration that runs Backstage's documentation hosted at https://backstage.io.
+
+It pulls content in from the [root `/docs`](../docs/) folder and builds it into the resulting HTML web site.
+
 This website was created with [Docusaurus](https://docusaurus.io/).
 
 # What's In This Document
@@ -10,6 +16,8 @@ This website was created with [Docusaurus](https://docusaurus.io/).
 
 # Getting Started
 
+Testing the web site locally is a great way to see what final website will look like after publishing, and is ideal for testing more complex changes, large updates to navigation, or complex page designs that may include special alignment, which may not otherwise be validated through continuous integration.
+
 ## Installation
 
 ```
@@ -22,7 +30,7 @@ $ yarn install
 $ yarn start
 ```
 
-This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.
+This command starts a local development server and opens up a browser window. Most content changes made to the `docs/` root folder are reflected live without having to restart the server.
 
 ## Build
 
@@ -57,9 +65,9 @@ my-docusaurus/
     siteConfig.js
 ```
 
-# Editing Content
+## Editing Content
 
-## Editing an existing docs page
+### Editing an existing docs page
 
 Edit docs by navigating to `docs/` and editing the corresponding document:
 
@@ -76,7 +84,7 @@ Edit me...
 
 For more information about docs, click [here](https://docusaurus.io/docs/en/navigation)
 
-## Editing an existing blog post
+### Editing an existing blog post
 
 Edit blog posts by navigating to `website/blog` and editing the corresponding post:
 
@@ -93,9 +101,9 @@ Edit me...
 
 For more information about blog posts, click [here](https://docusaurus.io/docs/en/adding-blog)
 
-# Adding Content
+## Adding Content
 
-## Adding a new docs page to an existing sidebar
+### Adding a new docs page to an existing sidebar
 
 1. Create the doc as a new markdown file in `/docs`, example `docs/newly-created-doc.md`:
 
@@ -126,7 +134,7 @@ My new content here..
 
 For more information about adding new docs, click [here](https://docusaurus.io/docs/en/navigation)
 
-## Adding a new blog post
+### Adding a new blog post
 
 1. Make sure there is a header link to your blog in `website/siteConfig.js`:
 
@@ -157,7 +165,7 @@ Lorem Ipsum...
 
 For more information about blog posts, click [here](https://docusaurus.io/docs/en/adding-blog)
 
-## Adding items to your site's top navigation bar
+### Adding items to your site's top navigation bar
 
 1. Add links to docs, custom pages or external links by editing the headerLinks field of `website/siteConfig.js`:
 
@@ -181,7 +189,7 @@ For more information about blog posts, click [here](https://docusaurus.io/docs/e
 
 For more information about the navigation bar, click [here](https://docusaurus.io/docs/en/navigation)
 
-## Adding custom pages
+### Adding custom pages
 
 1. Docusaurus uses React components to build pages. The components are saved as .js files in `website/pages/en`:
 1. If you want your page to show up in your navigation header, you will need to update `website/siteConfig.js` to add to the `headerLinks` element:
@@ -199,11 +207,11 @@ For more information about the navigation bar, click [here](https://docusaurus.i
 }
 ```
 
-For more information about custom pages, click [here](https://docusaurus.io/docs/en/custom-pages).
+Learn more about [Docusaurus custom pages](https://docusaurus.io/docs/en/custom-pages).
 
-# Full Documentation
+## Full Documentation
 
-Full documentation can be found on the [website](https://docusaurus.io/).
+Full documentation can be found on the [Docusaurus website](https://docusaurus.io/).
 
 ## Additional notes