Merge pull request #702 from Savvythelegend/chore/format-onboarding-section

docs(readme): refine formatting and fix typos

Author: leecalcote

README.md

@@ -55,17 +55,17 @@ Running the site locally is simple. Provided you have Docker installed, clone th
 
 ### With Golang
 
-If your local development environment has a supported version (v1.21.0+) of Golang installed, next you'll need to install extended hugo version as it has necessary SCSS/SASS support. Find all the hugo packages here: <https://github.com/gohugoio/hugo/releases/tag/v0.120.4>
+If your local development environment has a supported version (v1.21.0+) of Golang installed, next you'll need to install extended Hugo version as it has necessary SCSS/SASS support. Find all the Hugo packages here: <https://github.com/gohugoio/hugo/releases/tag/v0.120.4>
 
 Now to setup and run the site locally run:
 
 `make setup` followed by `make site`
 
 ...and then visit <http://localhost:1313>.
 
-If you pull down new code from GitHub, you will occasionally need run `make setup` again. Otherwise, there's no need to re-run `make setup` each time the site is run, you can just run `make site` to get it going and have it automatically reload as you make and save site edits.
+If you pull down new code from GitHub, you will occasionally need to run `make setup` again. Otherwise, there's no need to re-run `make setup` each time the site is run, you can just run `make site` to get it going and have it automatically reload as you make and save site edits.
 
-## Layer5 Documentation Stucture
+## Layer5 Documentation Structure
 
 ## High-Level Outline & Information Architecture for Layer5 Documentation
 
@@ -81,7 +81,7 @@ If you pull down new code from GitHub, you will occasionally need run `make setu
 ### Getting Started
 
 - **Setting up Layer5 Account:** With a personal account on Layer5 Cloud, you can import or create infrastructural designs, collaborate with others through workspaces and teams, manage your organizations and more.
-- **Creating a Design from Meshery Catalog Templates:** With this guide, you can create amazing cloud native designs for your infrastructure from already avaliable templetes in the meshery catalog.
+- **Creating a Design from Meshery Catalog Templates:** With this guide, you can create amazing cloud native designs for your infrastructure from already available templates in the meshery catalog.
 
 ### Concepts
 
@@ -129,13 +129,13 @@ Low-level ReST API reference for extending Layer5 Cloud.
 - **Starting from a pattern:** A Pattern is an entity that augments the operational behavior of a deployed instance of a Design.
 - **Creating Relationships:** Relationships identify and facilitate genealogy between Components.
 - **Working with Components:** Components represent entities in the Meshery ecosystem, exposing capabilities of the underlying platform.
-- **Starting from scratch:** Emphasiz the underlying system behavior for each action you take.
+- **Starting from scratch:** Emphasize the underlying system behavior for each action you take.
 
 ### Exploring Designer
 
 - **Reviewing Designs:** Learn how to leverage comments in Kanvas’s Designer Mode to enhance collaboration and streamline design reviews.
-- **Whiteboarding:** Whiteboarding and Freestyle Drawing inside kanvas
-- **Export Designs:** How to export your designs for backup , sharing or offline use.
+- **Whiteboarding:** Whiteboarding and Freestyle Drawing inside Kanvas
+- **Export Designs:** How to export your designs for backup, sharing or offline use.
 
 ### Working with Components
 
@@ -195,7 +195,7 @@ To display images in a pop-up modal, use the following syntax: `![alt text](/pat
 
 ### Adding Alert to the site
 
-Use the following Syntax to add a Alert:
+Use the following Syntax to add an Alert:
 `{{< alert type="success" title="Note" >}} Your Note {{< /alert >}}`
 
 - `type="danger"`: Alert used to indicate something related to security.
@@ -204,21 +204,23 @@ Use the following Syntax to add a Alert:
 - `type="note"`: Alert used to indicate a neutral information.
 - `type="success"`: Alert used to indicate a positive information.
 
-By default, if you don't specify a title `title="Your Title"`, the title will be the same as the type name.
+By default, if you don't specify a `title="Your Title"`, the title will be the same as the type name.
 
-**Note-> Using the wrong type will lead to the use of the default alert i.e. success**
+**Note-> Using an invalid alert type will lead to the default alert being used (i.e. success).**
 
 <hr/>
 
 <a name="contributing"></a><a name="community"></a>
-Our projects are community-built and welcome collaboration. 👍 Be sure to see the <a href="https://docs.google.com/document/d/17OPtDE_rdnPQxmk2Kauhm3GwXF1R5dZ3Cj8qZLKdo5E/edit">Layer5 Community Welcome Guide</a> for a tour of resources available to you and jump into our <a href="http://slack.layer5.io">Slack</a>!
+Our projects are community-driven and open to collaboration. 👍 Be sure to see the <a href="https://docs.google.com/document/d/17OPtDE_rdnPQxmk2Kauhm3GwXF1R5dZ3Cj8qZLKdo5E/edit">Layer5 Community Welcome Guide</a> for a tour of resources available to you. You can also join our <a href="http://slack.layer5.io">Slack</a> to get involved. 
 
 <p style="clear:both;">
 <a href ="https://layer5.io/community/meshmates"><img alt="MeshMates" src=".github/readme/images/layer5-community-sign.png" style="margin-right:10px; margin-bottom:15px;" width="28%" align="left"/></a>
 <h3>Find your MeshMate</h3>
 
-<p>MeshMates are experienced Layer5 community members, who will help you learn your way around, discover live projects and expand your community network.
-Become a <b>Meshtee</b> today!</p>
+<p>
+  MeshMates are experienced Layer5 community members who will help you learn your way around, discover live projects and expand your community network.
+  Become a <b>Meshtee</b> today!
+</p>
 
 Find out more on the <a href="https://layer5.io/community">Layer5 community</a>. <br />
 <br /><br /><br /><br />
@@ -237,7 +239,7 @@ Find out more on the <a href="https://layer5.io/community">Layer5 community</a>.
 <div>
 <a href="https://meshery.io/community"><img alt="Layer5 Community" src=".github/readme/images//community.svg" style="margin-right:8px;padding-top:9px;" width="140px" align="left" /></a>
 <p>
-✔️ <em><strong>Join</strong></em> any or all of the weekly meetings on <a href="https://calendar.google.com/calendar/b/1?cid=bGF5ZXI1LmlvX2VoMmFhOWRwZjFnNDBlbHZvYzc2MmpucGhzQGdyb3VwLmNhbGVuZGFyLmdvb2dsZS5jb20">community calendar</a>.<br />
+✔️ <em><strong>Join</strong></em> any or all of the weekly meetings on <a href="https://calendar.google.com/calendar/b/1?cid=bGF5ZXI1LmlvX2VoMmFhOWRwZjFnNDBlbHZvYzc2MmpucGhzQGdyb3VwLmNhbGVuZGFyLmdvb2dsZS5jb20">Community calendar</a>.<br />
 ✔️ <em><strong>Watch</strong></em> community <a href="https://www.youtube.com/playlist?list=PL3A-A6hPO2IMPPqVjuzgqNU5xwnFFn3n0">meeting recordings</a>.<br />
 ✔️ <em><strong>Access</strong></em> the <a href="https://drive.google.com/drive/u/4/folders/0ABH8aabN4WAKUk9PVA">Community Drive</a> by completing a community <a href="https://layer5.io/newcomer">Member Form</a>.<br />
 ✔️ <em><strong>Discuss</strong></em> in the <a href="https://discuss.layer5.io">Community Forum</a>.<br />