Small edits for clarity

Author: logseqramses

docs/1.Getting-Started/1.why-use-logseq.md

@@ -6,7 +6,7 @@ Whether you need to capture a task, meeting notes, or even run entire projects,
 
 But what makes Logseq truly different from most other notes apps?
 
-In this app, you write everything in *lists*. **Logseq is an outliner**, which means that you structure your notes while you type, in simple bulleted lists. And with this ease of structuring information, you no longer need to think about how to name a note or where to store it.
+In Logseq, you write everything in *lists*. **Logseq is an outliner**, which means that you structure your notes while you type, in simple bulleted lists. And with this ease of structuring information, you no longer need to think about how to name a note or where to store it.
 
 So how does a simple outlining app enable you to take, structure, and find your notes with ease? That’s the topic of this onboarding guide.
 
@@ -20,4 +20,4 @@ For now, let’s focus on the three most important concepts in Logseq:
 * Pages
 * References
 
-We’ll start with a brief overview of these core concepts, before zooming in on each one.
+We’ll start with a brief overview of these core concepts, before zooming in on each one.

docs/1.Getting-Started/2.the-only-features-you-need-to-start.md

@@ -6,10 +6,10 @@ In this part of the onboarding guide, we’ll have a brief look at Logseq’s co
 * Pages
 * References
 
-Confused about what these words mean? Let’s define things.
+Confused about what these words mean? Let’s define things:
 
 ### Blocks are like paragraphs
-Whenever you open Logseq, you always start on the journals section. This is a list of all of your journals pages, showing the most recent date first. In a bit we’ll explain what these pages do exactly, but first we need to take a moment to understand the most basic concept of Logseq: **blocks**.
+Whenever you open Logseq, you always start on the journals section. This is a list of all of your journals pages, showing the most recent date first. In a bit we’ll explain what these pages do exactly, but first we need to take a moment to understand a fundamental concept in Logseq: **blocks**.
 
 On that page with today’s date, you see a single bullet. This is called a _block_ in Logseq, and it’s the smallest piece of information you can work with in this app. You can compare blocks to paragraphs in a regular text editor.
 
@@ -47,4 +47,4 @@ Clicking on a block reference will show all of the contents of its branch inline
 
 Towards the end of this guide we’ll have a look at how to use references to search and navigate your notes.
 
-For now, [let’s first have a closer look at blocks](./3.write-in-blocks-and-branches).
+For now, [let’s first have a closer look at blocks](./3.write-in-blocks-and-branches).

docs/1.Getting-Started/3.write-in-blocks-and-branches.md

@@ -71,7 +71,7 @@ When you click on a bullet of a block, Logseq shows only that block and its chil
 ## How to manage blocks and branches
 To create a new block while you’re typing in another block, you only need to press the `Enter` key on your keyboard.
 
-When your cursor is at the end of a block, pressing `Enter` creates a new empty block. If there’s content after the cursor, pressing `Enter` moves that content into a new block:
+When the cursor is at the end of a block, pressing `Enter` creates a new empty block. If there’s content after the cursor, pressing `Enter` moves that content into a new block:
 
 <video width="100%" controls>
   <source src="./assets/3_7_EnterEmptyBlock.mp4" type="video/mp4">
@@ -89,9 +89,9 @@ When you hover underneath the last block, you’ll see a `+` icon appear at the
   <source src="./assets/3_9_AddBlockMouse.mp4" type="video/mp4">
 </video>
 
-To indent blocks and create branches, hit the `Tab` key when your cursor is in a block. This moves the block to the right, indenting it underneath the block directly above it. This creates a so-called _parent-child relationship_.
+To indent blocks and create branches, hit the `Tab` key when the cursor is in a block. This moves the block to the right, indenting it underneath the block directly above it. This creates a so-called _parent-child relationship_.
 
-Indentation only works when two blocks are on the same indentation level; if the block with your cursor is already indented, pressing `Tab` does nothing.
+Indentation only works when two blocks are on the same indentation level; if the block with the cursor is already indented, pressing `Tab` does nothing.
 
 <video width="100%" controls>
   <source src="./assets/3_4_IndentKb.mp4" type="video/mp4">
@@ -115,4 +115,4 @@ To _unindent _a block (or branch), you can use the `Shift + Tab` keyboard combin
 
 Writing your notes in blocks and branches may feel strange in the beginning. But trust us: the more you practice writing in outlines, the more natural it will feel. Soon, you can't imagine taking notes in another way.
 
-Let’s now zoom out from blocks and branches and have a look at the bigger pieces of information in Logseq: journals and pages.
+Let’s now zoom out from blocks and branches and have a look at the bigger pieces of information in Logseq: journals and pages.

docs/1.Getting-Started/5.link-your-notes-with-page-and-block-references.md

@@ -90,10 +90,10 @@ Another way to embed a block is to `Right-Click` the bullet of the block you wis
 Apart from showing the full context, embeds also allow you to edit blocks directly from the embed. This is not possible with page and block references, and you’d have to go to the source page or block to change its contents.
 
 ### Best practices for linking
-Before we move onto the recap of this entire onboarding guide, let’s take a moment to consider when to use page and block references, and when to go with embeds.
+Now the question remains: when to use page and block references, and when to go with embeds?
 
 Most Logseq users turn mentions of people, projects, companies, and other nouns into links (either tags of bracket links). Combined with Logseq’s outline structure, linking enables you to create little packets of information that are easy to find back (using the Linked References section).
 
 Block references are often used to quickly create outlines without the need to duplicate notes. Another common use case for block references is to create different versions of branches, as you can easily reference a block and create an alternative branch.
 
-Embeds are often used for dashboards or pages that need to show a lot of context. For example, you can create a single project page where you embed all relevant notes instead of moving them onto the page.
+Embeds are often used for dashboards or pages that need to show a lot of context. For example, you can create a single project page where you embed all relevant notes instead of moving them onto the page.