Merge branch '@ksienkiewicz/docs-fundamentals' into @ksienkiewicz/docs-rich-text-formatting

Author: hejsztynx

docs/docs/fundamentals/core-concepts.md

@@ -14,8 +14,8 @@ does and help you understand further chapters better.
 every keystroke back into React state. It owns its content on the native side
 and you talk to it through a `ref`.
 
-This is deliberate. Rich text changes constantly — every character, selection
-move and style toggle — and round-tripping all of that through JavaScript state
+This is deliberate. Rich text changes constantly - every character, selection
+move and style toggle - and round-tripping all of that through JavaScript state
 would be extremely slow and open to a possible de-synchronization of those states.
 Keeping it native makes the editor fast and stable.
 
@@ -56,8 +56,8 @@ All supported and canonical tags are listed in [Supported tags](/fundamentals/ht
 
 The library is split into an editor and a viewer:
 
-- **`EnrichedTextInput`** — the interactive editor from the previous page.
-- **`EnrichedText`** — a read-only display component that renders the input's
+- **`EnrichedTextInput`** - the interactive editor from the previous page.
+- **`EnrichedText`** - a read-only display component that renders the input's
   HTML.
 
 The HTML format that both components expect is identical, what allows you to integrate them seamlessly. A common setup edits in `EnrichedTextInput`, stores the `getHTML` output, and later displays it with `EnrichedText`.
@@ -66,12 +66,12 @@ 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`** - 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
+- **`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.
+- **`isConflicting`** - 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.
 

docs/docs/fundamentals/getting-started.md

@@ -19,7 +19,7 @@ React Native Enriched HTML is a rich text solution for React Native built by
 
 It ships two fully native components: `EnrichedTextInput`, a rich text editor
 that styles text live as you type, and `EnrichedText`, a read-only display component that
-renders the input's output. Both speak HTML — the input
+renders the input's output. Both speak HTML - the input
 produces it, the display consumes it.
 
 Not only does this library allow you to apply basic rich text styles you know well,

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

@@ -4,18 +4,18 @@ sidebar_position: 4
 
 # HTML format and supported tags
 
-The editor works with a fixed set of standard and custom HTML tags — it both
+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.
 
 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
 freely, and there are two kinds of restriction:
 
-- **Conflicting** — toggling a style that conflicts with an active one replaces
+- **Conflicting** - toggling a style that conflicts with an active one replaces
   it. Toggling `<h2>` on a `<blockquote>` paragraph removes the blockquote and
   applies the heading.
-- **Blocking** — a blocked style can't be toggled at all while the blocking
+- **Blocking** - a blocked style can't be toggled at all while the blocking
   style is active. `<b>` is blocked inside `<codeblock>`, so bold can't be
   applied there.
 
@@ -45,7 +45,7 @@ of it is redundant and therefore blocked.
 
 ## Paragraph tags
 
-Only one paragraph-level style can be active per paragraph — they all conflict
+Only one paragraph-level style can be active per paragraph - they all conflict
 with each other.
 
 Some paragraph styles are containers that wrap each line inside them with an

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

@@ -15,7 +15,7 @@ the library: **calling methods on the input** and **reading its state back**.
 ## Rendering the input
 
 Start by dropping an `EnrichedTextInput` on the screen. It behaves like a
-regular `TextInput` — give it a `style` and a `placeholder` and you have a
+regular `TextInput` - give it a `style` and a `placeholder` and you have a
 working editor.
 
 ```tsx
@@ -48,7 +48,7 @@ const styles = StyleSheet.create({
 
 ## Toggling a style
 
-The input is uncontrolled — you don't change its content through props. Instead
+The input is uncontrolled - you don't change its content through props. Instead
 you call methods on it through a `ref` of type `EnrichedTextInputInstance`.
 
 Add a ref and a button that calls `toggleBold`. Each call flips bold on the
@@ -103,7 +103,7 @@ const styles = StyleSheet.create({
 });
 ```
 
-Every other style is toggled similarly via `ref` — there's a `toggleItalic`,
+Every other style is toggled similarly via `ref` - there's a `toggleItalic`,
 `toggleUnderline`, `toggleH1`, `toggleOrderedList`, and so on.
 
 ## Reading the state back
@@ -194,7 +194,7 @@ lists which styles clash with each other.
 
 ## Try it out
 
-Here's that editor running live on this page. Select some text and hit **Bold** —
+Here's that editor running live on this page. Select some text and hit **Bold** -
 notice the button turns green whenever the cursor sits on bold text. Switch to
 the **Code** tab to see the exact source.