Reword docs

Author: Edvinas01

Documentation~/README.md

@@ -14,9 +14,9 @@ The documented features can be imported as samples via [Unity Package Manager] f
 </p>
 
 ## Getting Started (Simple Events)
-The simplest use case of _Scriptable Events_ is when you want to notify a system that something happened without providing any context. To do so, you need two elements: a _Simple Scriptable Event_ and a _Simple Scriptable Event Listener_.
+The simplest use case of _Scriptable Events_ is when you need to notify a system that something happened without providing any context. To do so, you need two elements: a _Simple Scriptable Event_ and a _Simple Scriptable Event Listener_.
 
-First, create a _Simple Scriptable Event_ asset by right-clicking in the project window and selecting _Scriptable Events/Simple Scriptable Event_. You can name the event as you prefer and place it anywhere in your project:
+First, create a _Simple Scriptable Event_ asset by right-clicking in the project window and selecting _Create/Scriptable Events/Simple Scriptable Event_. You can name the event as you prefer and place it anywhere in your project:
 <p align="center">
   <img src="simple-scriptable-event.png"/>
 </p>
@@ -26,15 +26,15 @@ Next, select a _GameObject_ in the scene and add a _Simple Scriptable Event List
   <img src="simple-scriptable-event-listener.png"/>
 </p>
 
-Once you've added a listener, insert your event asset into the _Scriptable Event_ field (1). In the _On Raised_ [Unity Event] field (2), insert the methods you'd like to be triggered by the event. For example, if you wanted to change a color of an object, your setup might look like the following as seen in the _Simple Events_ sample:
+Once you've added a listener, insert your event asset into the _Scriptable Event_ field (1). In the _On Raised_ [Unity Event] field (2) add the methods you'd like to be triggered by the event. For example, if you need to change a color of an object, your setup might look like the following as seen in the _Simple Events_ sample:
 <p align="center">
   <img src="simple-scriptable-event-sample.png"/>
 </p>
 
-Now that you have your listener ready, you need to trigger the event. This can be done from a [Unity Event] by calling `SimpleScriptableEvent.Raise` method or by selecting the event asset and clicking the _Raise_ button when the game is running:
+Now that you have your listener ready, you need to trigger the event. This can be done from a [Unity Event] by calling `SimpleScriptableEvent.Raise` method or by selecting the event asset and clicking the _Raise_ button during runtime:
 <p align="center">
-  <img hspace="2%" width="45%" src="simple-scriptable-event-raise-unity-event.png"/>
-  <img hspace="2%" width="45%" src="simple-scriptable-event-raise.png"/>
+  <img hspace="2%" width="40%" src="simple-scriptable-event-raise-unity-event.png"/>
+  <img hspace="2%" width="40%" src="simple-scriptable-event-raise.png"/>
 </p>
 
 Alternatively you can trigger the event via code:
@@ -55,17 +55,17 @@ public class TriggerEvent : MonoBehaviour
 ```
 
 ## Passing Arguments (Events With Arguments)
-In most situations you'll want to pass an argument when triggering an event. For example, if the player takes damage, you might want to notify your systems with the amount of damage taken.
+In some situations might need to pass an argument when triggering an event. For example, if the player takes damage, you might need to notify your systems with the amount of damage taken.
 
-For such uses cases, this package provides a set of events with commonly used argument types. To create an event asset which accepts an argument, right-click in the project window and select an event from _Scriptable Events/_ menu which has the required type:
+For such uses cases, this package provides a set of events with commonly used argument types. To create an event asset which accepts an argument, right-click in the project window and select an event from _Create/Scriptable Events/*_ menu which has the required type:
 <p align="center">
   <img src="scriptable-event-arg.png"/>
 </p>
 
-Next, you'll want to add a listener. Each corresponding _Scriptable Event_ type provides a listener component. Each typed listener works in the same fashion as _Simple Scriptable Event Listener_. The only caveat is when inserting your methods into the _On Raised_ [Unity Event] field. In this case make sure to select a **dynamic** method:
+Next, you'll need to add a listener. Each corresponding _Scriptable Event_ type provides a listener component. Each typed listener works in the same fashion as _Simple Scriptable Event Listener_. The only caveat is when inserting your methods into the _On Raised_ [Unity Event] field. In this case make sure to select a **dynamic** method:
 <p align="center">
-  <img hspace="2%" width="45%" src="scriptable-event-listener-components.png"/>
-  <img hspace="2%" width="45%" src="scriptable-event-listener-dynamic.png"/>
+  <img hspace="2%" width="40%" src="scriptable-event-listener-components.png"/>
+  <img hspace="2%" width="40%" src="scriptable-event-listener-dynamic.png"/>
 </p>
 
 To trigger the event follow the same steps as with _Simple Scriptable Event_. However, make sure to select a **dynamic** `Raise` method:
@@ -94,9 +94,9 @@ public class TriggerEvent : MonoBehaviour
 ```
 
 ## Creating Custom Events (Custom Events)
-In some cases using the built-in argument types is not sufficient. For example, if the player takes damage, you might also want to pass a reference to the object that dealt damage to the player. In this case passing only the damage taken is not enough, you need to pass a `class` argument which contains both of those values. For this you'll need to create a custom event.
+In some cases using the built-in argument types is not sufficient. For example, if the player takes damage, you might also need to pass a reference to the object that dealt damage to the player. In this case passing only the damage taken is not enough, you need to pass a `class` argument which contains both of those values. For this you'll need to create a custom event.
 
-To start, create a container `class` for your event data. In this case we'll pass the values needed to change the `Metallic` and `Color` properties of a material:
+To start, create a container `class` for your event data. In this example we'll pass the values needed to change the `Metallic` and `Color` properties of a material:
 ```cs
 public class MaterialData
 {
@@ -164,7 +164,7 @@ public class MaterialOptionsHandler : MonoBehaviour
 }
 ```
 
-Optionally you can add a custom editor for your event. This will allow you to click the _Raise_ button on your custom event during runtime. To do so, create an editor class which inherits `BaseScriptableEventEditor` in the **Editor** directory:
+**Optionally** you can add a custom editor. This will allow you to click the _Raise_ button on your custom event asset during runtime. To do so, create an editor class which inherits `BaseScriptableEventEditor`. Make sure to place this class in the **Editor** directory, or your project will not build:
 ```cs
 using ScriptableEvents.Editor;
 using UnityEditor;