docs: punctuation and general clarification

Co-authored-by: Mikołaj Szydłowski <9szydlowski9@gmail.com>

Author: hejsztynx

docs/docs/fundamentals/core-concepts.md

@@ -47,7 +47,7 @@ lists exactly what it produces and accepts.
 
 Sanitizing HTML is your responsibility. The library doesn't guarantee safe HTML on mobile, so
 sanitize anything you persist, render elsewhere, or accept from untrusted
-sources. To learn how sanitization is handled on Web, see [Web support](/core-functionalities/web-support)
+sources. To learn how sanitization is handled on Web, see [Web support](/core-functionalities/web-support).
 
 :::
 
@@ -61,9 +61,9 @@ All supported and canonical tags are listed in [Supported tags](/fundamentals/ht
 
 ## Two components, one HTML format
 
-The library is split into an editor and a viewer:
+The library is split into an editor and a display:
 
-- **`EnrichedTextInput`** - the interactive editor from the previous page.
+- **`EnrichedTextInput`** - an interactive editor that emits HTML.
 - **`EnrichedText`** - a read-only display component that renders the input's
   HTML.
 
@@ -73,13 +73,13 @@ The HTML format that both components expect is identical, what allows you to int
 
 Not every style can be combined with every other. For example, a paragraph can't be both a heading and a list item, code blocks don't support inline formatting such as bold or italic. The editor tracks this and reports it through `onChangeState`, which gives each style three booleans:
 
-- **`isActive`** - the style is applied at the current selection. Use it to
+- **`isActive`** - whether the style is applied at the current selection. Use it to
   highlight a toolbar button.
-- **`isBlocking`** - another active style forbids this one entirely, so toggling
-  it would do nothing. For example bold is blocked inside a code block. Use it
-  to disable a button.
-- **`isConflicting`** - this style would replace an active one if toggled on.
-  For example switching a blockquote paragraph to a heading removes the
+- **`isBlocking`** - whether another active style forbids this one entirely, so toggling
+  it would do nothing. For example, bold is blocked inside a code block. Use it
+  to disable a toolbar button.
+- **`isConflicting`** - whether this style would replace an active one if toggled on.
+  For example, switching a blockquote paragraph to a heading removes the
   blockquote. Use it to hint that the toggle is a swap, not an addition.
 
 Driving your toolbar from these three flags keeps the UI honest: buttons light

docs/docs/fundamentals/html-format-and-supported-tags.md

@@ -4,12 +4,10 @@ sidebar_position: 4
 
 # HTML format and supported tags
 
-The editor works with a fixed set of standard and custom HTML tags - it both
-produces them in its output and accepts them as input. This page is the
-reference for that set.
+The provided components work with a fixed set of standard and custom HTML tags - the editor produces them and they can be used as input to both the editor and the display component. This page is the reference for that set.
 
 Styles fall into two groups: **inline** tags that wrap a range of characters,
-and **paragraph** tags that apply to whole lines. Not all of them combine
+and **paragraph** tags that apply to whole paragraphs (**a paragraph might span a few lines!**). Not all of them combine
 freely, and there are two kinds of restriction:
 
 - **Conflicting** - toggling a style that conflicts with an active one replaces

docs/docs/fundamentals/your-first-editor.mdx

@@ -184,15 +184,15 @@ const styles = StyleSheet.create({
 });
 ```
 
-That's the full loop: the button **acts** on the input with `toggleBold`, and
+That's the full loop: the button **acts** on the input with `toggleBold` and
 the input **reports** the result through `onChangeState`. A real toolbar is just
 this repeated for every style.
 
 :::tip
 
 Each `onChangeState` entry carries more than `isActive`. `isBlocking` and
 `isConflicting` tell you when a style can't be applied on top of the current
-one. [Core concepts](/fundamentals/core-concepts) explains the full state model,
+one or conflicts with it. [Core concepts](/fundamentals/core-concepts) explains the full state model,
 and [Supported tags](/fundamentals/html-format-and-supported-tags)
 lists which styles clash with each other.