Slightly improve writing style

Author: Mario Borna Mjertan

website/docs/basics/basics-intro.md

@@ -3,7 +3,8 @@ id: basics-intro
 title: Basics
 ---
 
-Before WordPress 5.0 release, the themes were mostly PHP based on some JavaScript and CSS. Now it's a bit different because we have PHP in the core, JavaScript (specifically React.js) in the block editor, and some styles in the editor and the theme parts of the website.
+Prior to WordPress 5.0, themes were mostly PHP-based, with JavaScript used only to provide interactive functionality on the website. 
+Now it's a bit different because we have PHP in the core, JavaScript (specifically React.js) in the block editor, and some styles in the editor and the theme parts of the website.
 
 Now that everything is different, we must adapt to the changes as well.
 

website/docs/basics/wp-cli.md

@@ -3,13 +3,13 @@ id: wp-cli
 title: WP-CLI
 ---
 
-[![docs-source](https://img.shields.io/badge/source-eigthshift--libs-blue?style=for-the-badge&logo=php&labelColor=2a2a2a)](https://github.com/infinum/eightshift-libs)
+[![docs-source](https://img.shields.io/badge/source-eightshift--libs-blue?style=for-the-badge&logo=php&labelColor=2a2a2a)](https://github.com/infinum/eightshift-libs)
 
-We have already mentioned the WP-CLI feature of Eightshift Boilerplate. Now, let's dig a little deeper into this awesome feature. We took our time to set up a bunch of WP-CLI commands that will help you set everything up and use all our features without worrying about correct names, files, and organization.
+Eightshift Development Kit provides extensive [WP-CLI](https://wp-cli.org/) tooling, allowing you to automate bootstrapping of common code, adding blocks from the Frontend Libs library to your projects and more using `wp boilerplate`.
 
 ## How it works
 
-In your project's entry point, you have something like this:
+In your project's entry point (usually `functions.php`), you'll find something along these lines:
 
 ```php
 /**
@@ -20,13 +20,13 @@ if (class_exists(Cli::class)) {
 }
 ```
 
-This code loads WP-CLI class from Eightshift Libs responsible for registering all of our custom commands. Keep in mind that, since WP-CLI code loads inside the theme/plugin, that same theme/plugin **must** be activated in the WordPress admin.
+This code loads the WP-CLI class from Eightshift Libs, which handles command registration for all of our commands. As this command registration is part of the theme/plugin code, this means that the same theme/plugin **must be activated** for `wp boilerplate` to work.
 
 To run the WP-CLI command and see what you can use, run this command in your terminal:
 
 `wp boilerplate --help`
 
-> By default, your project's WP-CLI commands run under the parent name `boilerplate` defined in the upper code.
+> By default, your project's WP-CLI commands run under the parent name `boilerplate`, as defined above.
 
 You can change that by simply replacing the string inside the load method like this:
 
@@ -39,23 +39,22 @@ if (class_exists(Cli::class)) {
 }
 ```
 
-Now, your project's WP-CLI loads like this:
+Now, your project's WP-CLI commands are available using:
 
 `wp superCoolTheme --help`.
 
 This is especially handy when you have multiple Eightshift Boilerplate powered themes or plugins installed. In that case, you should change the WP-CLI parent name on each of the projects.
 
 ## Options and commands
 
-When you type each command in the terminal, it will do some action. Some commands will ask you for additional parameters. You can see them if you run the `command name` and `--help` like this:
+To get to know which commands are available and what do they do, run `wp boilerplate --help`. 
+The `--help` argument is available on all of our commands and provides a description of the command and a list of required and optional parameters for the command.
 
 `wp boilerplate create_config --help`
 
-Under the `OPTIONS`, you can see all required and optional parameters you can pass to the command to fine-tune your output.
-
 ### Commands
 
-We have defined a few command prefixes:
+We use these common prefixes for commands:
 
 - **create** - services classes that will be copied to your project.
 - **init** - additional functions, methods and helpers that will be copied to your project.
@@ -65,16 +64,15 @@ We have defined a few command prefixes:
 
 > **Make WP-CLI your best friend, and your coding life will be much more comfortable, trust us.**
 
-We will explain some classes that we think are necessary in more detail in the next chapter. For the rest of the classes, you can find the descriptions by running `--help` after each command.
-
+While we might go into more details about some of these commands, we won't be documenting all of them here - use the built-in manuals for more information about particular commands and to discover what's available. Don't gloss over them, as using `wp boilerplate` is a particularly useful tool when building projects with Eightshift Development Kit.
 ## Running commands in multisite
 
-When you are running a multisite setup you must always provide the additional `--url` parameter because without that parameter WordPress will always run the code from the current primary domain set in the `wp-config.php`.
+When you are running a multisite setup, you should always provide the additional `--url` parameter. Otherwise, WP-CLI will always run the command on the main site.
 
-Here is an example for command running from the primary domain:
+Here is an example for command running on the primary site:
 
 `wp boilerplate create_config`
 
-and here is an example for command running in the sub site:
+and here is an example for command running on the subsite:
 
 `wp boilerplate create_config --url='custom.domain.com'`

website/docs/eightshift-frontend-libs.md

@@ -3,27 +3,26 @@ id: eightshift-frontend-libs
 title: Eightshift Frontend Libs
 ---
 
-[![docs-source](https://img.shields.io/badge/source-eigthshift--frontend--libs-yellow?style=for-the-badge&logo=javascript&labelColor=2a2a2a)](https://github.com/infinum/eightshift-frontend-libs/tree/develop/blocks/init/src/blocks/)
+[![docs-source](https://img.shields.io/badge/source-eightshift--frontend--libs-yellow?style=for-the-badge&logo=javascript&labelColor=2a2a2a)](https://github.com/infinum/eightshift-frontend-libs/tree/develop/blocks/init/src/blocks/)
 
-This library is meant to bring the modern front-end development tools to the [Eightshift Boilerplate](https://github.com/infinum/eightshift-boilerplate) or [Eightshift Boilerplate Plugin](https://github.com/infinum/eightshift-boilerplate-plugin), but you can use it on any WordPress project.
+This library is meant to bring modern front-end development tools to the [Eightshift Boilerplate](https://github.com/infinum/eightshift-boilerplate) or [Eightshift Boilerplate Plugin](https://github.com/infinum/eightshift-boilerplate-plugin), but you can use it on any WordPress project.
 
 ## Prerequisites
 
 The knowledge of the core editor components and React.js is recommended, since this library is focused on working with the new block editor and contains custom blocks. If you want to create your custom blocks, that knowledge will come in handy.
 
-The library can be used for pure Webpack/JS/Scss functionality, but if you want to use our blocks, [Eightshift Libs](https://github.com/infinum/eightshift-libs/) must be used in tandem because they handle block registration, etc.
+The library can be used for pure Webpack/JS/SCSS functionality, but if you want to use our blocks, [Eightshift Libs](https://github.com/infinum/eightshift-libs/) must be used in tandem because they handle block registration, attribute handling and more.
 
 ### The library contains:
 
 - All JS packages required for the Webpack build
 - ESLint ruleset
-- StyleLint ruleset
+- Stylelint ruleset
 - Babel ruleset
 - A collection of useful front-end utility modules
 - The complete storybook of over 30+ useful blocks and components
-- Block editor block example
-- Block editor blocks initial setup for the [Eightshift Boilerplate](https://github.com/infinum/eightshift-boilerplate)
-- Some cool custom components for block editor
+- Block editor block examples
+- A growing collection of blocks and components
 - The complete Webpack build for [Eightshift Boilerplate](https://github.com/infinum/eightshift-boilerplate)
 - Helpers for creating dynamic block editor blocks
 - ...

website/docs/theme.md

@@ -22,14 +22,14 @@ All additional steps after the initial setup are done using WP_CLI commands, so
 
 ## Specify version to create
 
-In order to be able to test boilerplate with different library versions you can provide 2 additions attributes to this command and specify library versions. 
+If you want to specify a version of Eightshift Libs or Frontend Libs to use, you can use add two additional attributes to this command to specify a branch or release to use:
 
 * `--eightshiftLibsBranch`
 * `--eightshiftFrontendLibsBranch`
 
 #### Example:
 
-If you want to pull a `develop` branch for the Eightshift frontend libs and a specific branch of the Eightshift libs your command will look like this:
+If you want to pull the `develop` branch of the Eightshift Frontend libs and a specific release of the Eightshift Libs:
 
 ```bash
 npx create-wp-project --eightshiftLibsBranch="release/3.1.0" --eightshiftFrontendLibsBranch="develop"
@@ -50,6 +50,6 @@ npx create-wp-project --help
 > You can specify both libraries at once or only one.
 
 ## What is next?
-Now that we have the theme set on your local environment, let's do something with it.
+Now that we've set the theme up on your local environment, let's do something with it.
 
 Please make sure you read the [Basics chapter](basics/basics-intro) to understand better how the project is set and what is included to make your developing experience as smooth as possible.

website/docs/versions.md

@@ -3,7 +3,7 @@ id: versions
 title: Versions
 ---
 
-Now that you understand what makes Eightshift tick, here is a quick reminder about what library versions this documentation refers to.
+Now that you understand what makes the Eightshift Development Kit tick, here is a quick reminder about what library versions this documentation refers to.
 
 [![docs-source](https://img.shields.io/badge/version--6.0.0-eightshift--boilerplate-red?style=for-the-badge&logo=)](https://github.com/infinum/eightshift-boilerplate)