Review of PR.

docs/source/theming/theming-a-base-theme.md

@@ -1,16 +1,24 @@
 ---
 html_meta:
-  "description": "Customize a base theme like `Volto Light Theme` via SCSS."
-  "property=og:description": "Customize a base theme like `Volto Light Theme` via SCSS."
-  "property=og:title": "Theming a base theme like `Volto Light Theme`"
+  "description": "Customize a base theme such as Volto Light Theme via SCSS."
+  "property=og:description": "Customize a base theme such as Volto Light Theme via SCSS."
+  "property=og:title": "Theming a base theme such as Volto Light Theme"
   "keywords": "Volto, Plone, frontend, React, themes, Volto Light Theme"
 ---
 
-# Theming a base theme like `Volto Light Theme`
+# Customize a base theme
 
-In your Volto addon, create a `theme` folder with the follwing two empty files:
+You can customize a base theme for your add-on.
+The following examples use [Volto Light Theme](https://github.com/kitconcept/volto-light-theme) as a base theme.
 
-```
+
+## File structure
+
+In your Volto add-on's {file}`src` folder, create a subfolder named {file}`theme`.
+Inside {file}`theme` create two empty files named {file}`_main.scss` and {file}`_variables.scss`.
+Refer to the following file system diagram.
+
+```text
 src/
 ├── components
 ├── index.js
@@ -19,18 +27,19 @@ src/
     └── _variables.scss
 ```
 
-## Variables
-`_variables.scss`
 
-This is the place to override SCSS variables of the base theme.
+## `_variables.scss`
 
-```
+{file}`_variables.scss` is where you can override SCSS variables of the base theme.
+
+```scss
 $text-color: #000;
 $font-size: 18px;
 $line-height: 24px;
 ```
 
-## Main
-`_main.scss`
 
-All custom styles should done here. You can also include other SCSS or CSS files here.
+## `_main.scss`
+
+{file}`_main.scss` is where you should put all custom styles.
+You can also include other SCSS or CSS files here.