diff --git a/README.md b/README.md
index 8d412c9d..134961ce 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 ![screenshot-dark](https://user-images.githubusercontent.com/433545/85227778-b42abc80-b3df-11ea-9dd3-e788f6c71882.png)
 
-A lightweight text editor written in Lua, adapted from [Lite](https://github.com/rxi/lite)
+A lightweight text editor written in Lua, adapted from [lite](https://github.com/rxi/lite)
 
 * **[Get Lite XL](https://github.com/franko/lite-xl/releases/latest)** — Download
   for Windows and Linux
@@ -12,42 +12,47 @@ A lightweight text editor written in Lua, adapted from [Lite](https://github.com
 * **[Get color themes](https://github.com/rxi/lite-colors)** — Add additional colors
   themes
 
-Please note that Lite XL is compatible with Lite for all the plugins and color themes.
-Yet we provide a specific lite-plugins directory for Lite XL because in some cases some adaptations may be needed to make them work better with Lite XL.
-The address for modified plugins is http://github.com/franko/lite-plugins.
-Currently only the "workspace" plugin needs a minor adjustment to restore the workspace when the command `core:restart` is used.
+Please note that Lite XL is compatible with lite for most plugins and all color themes.
+We provide a separate lite-plugins repository for Lite XL, because in some cases some adaptations may be needed to make them work better with Lite XL.
+The repository with modified plugins is http://github.com/franko/lite-plugins.
 
 The changes and differences between Lite XL and rxi/lite are listed in the [changelog](https://github.com/franko/lite-xl/blob/master/changelog.md).
 
 ## Overview
-Lite XL is derived from Lite. It is a lightweight text editor written mostly in Lua — it aims to provide
+Lite XL is derived from lite. It is a lightweight text editor written mostly in Lua — it aims to provide
 something practical, pretty, *small* and fast easy to modify and extend, or to use without doing either.
 
-The aim of Lite XL compared to Lite is to be more user friendly, improve the quality of the font rendering and reduce CPU usage.
+The aim of Lite XL compared to lite is to be more user friendly, improve the quality of font rendering, and reduce CPU usage.
 
 ## Customization
-Additional functionality can be added through plugins which are available from
-the [plugins repository](https://github.com/rxi/lite-plugins) or from the [plugin repository adapted to Lite XL](https://github.com/franko/lite-plugins); additional color
-themes can be found in the [colors repository](https://github.com/rxi/lite-colors).
-The editor can be customized by making changes to the
-[user module](data/user/init.lua).
+Additional functionality can be added through plugins which are available in
+the [plugins repository](https://github.com/rxi/lite-plugins) or in the [Lite XL-specific plugins repository](https://github.com/franko/lite-plugins).
+
+Additional color themes can be found in the [colors repository](https://github.com/rxi/lite-colors).
+These color themes are bundled with all releases of Lite XL by default.
+
+The editor can be customized by making changes to the [user module](data/user/init.lua).
 
 ## Building
 
-You can build the project yourself using the Meson build.
+You can build Lite XL yourself using Meson.
 
-In addition the script `build-packages.sh` can be used to compile Lite XL and create a package adapted to the OS, Linux, Windows or Mac OS X.
+In addition, the `build-packages.sh` script can be used to compile Lite XL and create an OS-specific package for Linux, Windows or macOS.
 
 The following libraries are required:
 
 - freetype2
 - SDL2
 
-The libraries libagg and Lua 5.2 are optional.
-If they are not found they will be automatically downloaded and compiled by the Meson build system.
-Otherwise, if they are present they will be used to compile Lite XL.
+The following libraries are optional:
 
-On a debian based systems the required library and Meson can be installed using the commands:
+- libagg
+- Lua 5.2
+
+If they are not found, they will be downloaded and compiled by Meson.
+Otherwise, if they are present, they will be used to compile Lite XL.
+
+On Debian-based systems the required libraries and Meson can be installed using the following commands:
 
 ```sh
 # To install the required libraries:
@@ -65,43 +70,41 @@ meson compile -C build
 meson install -C build
 ```
 
-When performing the "meson setup" command you may enable the "portable" option to choose the
-kind of install.
+When performing the `meson setup` command you may enable the `-Dportable=true` option to specify whether a portable build should be done.
 
-If the portable option latter is enabled Lite XL is built to use a "data" and a "user" directory
-from the same directory of the executable.
-If "portable" is not enabled (this is the default) Lite XL will use unix-like
-directory locations.
-In this case the "data" directory will be `$prefix/share/lite-xl` and the "user"
+If `portable` is enabled, Lite XL is built to use `data` and `user` directories placed next to the executable.
+Otherwise, Lite XL will use Unix-like directory locations.
+In this case, the `data` directory will be located in `$prefix/share/lite-xl`, and the `user`
 directory will be `$HOME/.config/lite-xl`.
-The `$prefix` is determined as the directory such as `$prefix/bin` corresponds to
-the location of the executable.
-The `$HOME` is determined from the corresponding environment variable.
+`$prefix` is determined such that `$prefix/bin` corresponds to the location of the executable.
+`$HOME` is determined from the corresponding environment variable.
 As a special case on Windows the variable `$USERPROFILE` will be used instead.
 
-If you compile lite-xl yourself it is recommended to use the script `build-packages.sh`:
+If you compile Lite XL yourself, it is recommended to use the script `build-packages.sh`:
 
 ```sh
 bash build-packages.sh <arch>
 ```
 
-It will run meson and create two zip files, one for the portable version and
-one for the unix-like version. Lite XL can be easily installed by unpacking one
-of the zip archive in a directory of your choice.
+The script will run Meson and create two .zip files, one for the portable version, and
+another one for the Unix-like version. Lite XL can be easily installed by unpacking one
+of these .zip archives in some directory of your choice.
 
-Please note that no directory is not hard-coded in the exectuable so that the
+Please note that there aren't any hard-coded directories in the executable, so that the
 package can be extracted and used in any directory.
 
-Note also that the unix-like package can work on windows as well.
+Note that the Unix-like package can also work on Windows.
 
-Please note that while compiling Lite XL on Mac OS X should work Mac OS X is not
-officially supported.
+Please note that while compiling Lite XL on macOS should work, macOS is not officially supported.
 
 ## Contributing
 Any additional functionality that can be added through a plugin should be done
-so as a plugin, after which a pull request to the
+as a plugin, after which a pull request to the
 [plugins repository](https://github.com/rxi/lite-plugins) can be made.
 
+If the plugin uses any Lite XL-specific functionality, please open a pull request to the
+[Lite XL plugins repository](https://github.com/franko/lite-plugins).
+
 Pull requests to improve or modify the editor itself are welcome.
 
 ## License