usage cleanup, convert raw html to md

Author: risadams

CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 First off, thanks for taking the time to contribute! ❤️
 
-All types of contributions are encouraged and valued. See the [Table of Contents](#table-of-contents) for different ways to help and details about how this project handles them. Please make sure to read the relevant section before making your contribution. It will make it a lot easier for us maintainers and smooth out the experience for all involved. The community looks forward to your contributions. 🎉
+All types of contributions are encouraged and valued. See the [Table of Contents](#table-of-contents) for different ways to help and details about how this project handles them. Please make sure to read the relevant section before making your contribution. It will make it easier for us maintainers and smooth out the experience for all involved. The community looks forward to your contributions. 🎉
 
 > And if you like the project, but just don't have time to contribute, that's fine. There are other easy ways to support the project and show your appreciation, which we would also be very happy about:
 >
@@ -82,11 +82,11 @@ Once it's filed:
 
 - The project team will label the issue accordingly.
 - A team member will try to reproduce the issue with your provided steps. If there are no reproduction steps or no obvious way to reproduce the issue, the team will ask you for those steps and mark the issue as `needs-repro`. Bugs with the `needs-repro` tag will not be addressed until they are reproduced.
-- If the team is able to reproduce the issue, it will be marked `needs-fix`, as well as possibly other tags (such as `critical`), and the issue will be left to be [implemented by someone](#your-first-code-contribution).
+- If the team can reproduce the issue, it will be marked `needs-fix`, as well as possibly other tags (such as `critical`), and the issue will be left to be [implemented by someone](#your-first-code-contribution).
 
 ### Suggesting Enhancements
 
-This section guides you through submitting an enhancement suggestion for Selectize, **including completely new features and minor improvements to existing functionality**. Following these guidelines will help maintainers and the community to understand your suggestion and find related suggestions.
+This section guides you through submitting an enhancement suggestion for Selectize, **including entirely new features and minor improvements to existing functionality**. Following these guidelines will help maintainers and the community to understand your request and find related suggestions.
 
 #### Before Submitting an Enhancement
 
@@ -102,7 +102,7 @@ Enhancement suggestions are tracked as [GitHub issues](https://github.com/select
 - Use a **clear and descriptive title** for the issue to identify the suggestion.
 - Provide a **step-by-step description of the suggested enhancement** in as many details as possible.
 - **Describe the current behavior** and **explain which behavior you expected to see instead** and why. At this point, you can also tell which alternatives do not work for you.
-- You may want to **include screenshots and animated GIFs** which help you demonstrate the steps or point out the part to which the suggestion is related. You can use [this tool](https://www.cockos.com/licecap/) to record GIFs on macOS and Windows, and [this tool](https://github.com/colinkeenan/silentcast) or [this tool](https://github.com/GNOME/byzanz) on Linux. <!-- this should only be included if the project has a GUI -->
+- You may want to **include screenshots and animated GIFs** which help you demonstrate the steps or point out the part to which the suggestion is related. You can use [this tool](https://www.cockos.com/licecap/) to record GIFs on macOS and Windows and [this tool](https://github.com/colinkeenan/silentcast) or [this tool](https://github.com/GNOME/byzanz) on Linux. <!-- this should only be included if the project has a GUI -->
 - **Explain why this enhancement would be useful** to most Selectize users. You may also want to point out the other projects that solved it better and which could serve as inspiration.
 
 ### Your First Code Contribution
@@ -117,9 +117,9 @@ Running `make` will build the project, run all tests, and update the distributio
 
 Running `npm start` on your repo will start a web server allowing you to view a local copy of this documentation, where you can test your changes against our example pages.
 
-If you are adding a new plugin, you should also add a corresponding example page to the `/docs/docs/plugins` directory.
+If you are adding a new plugin, you should add a corresponding example page to the `/docs/docs/plugins` directory.
 
-You can then run the examples at `http://localhost:4000/`.
+You can then run the examples at `https://loopback.website:4000/`.
 
 ### Improving The Documentation
 
@@ -134,7 +134,5 @@ If you're motivated to fix a bug or to develop a new feature, we'd love to see y
 - Make sure tests pass: Run `npm test` to make sure your changes don't break existing functionality
 - Do not make changes to files in `/dist`. Limiting your edits to files in `/src` directories keeps the size of your pull request down and makes it easier for us to evaluate. We'll update the `/dist` folder after your pull request is approved.
 - Add tests: In the best-case scenario, you are also adding tests to back up your changes, but don't sweat it if you don't. We can discuss them at a later date.
-- Squash your commits together in one or a few complete, logical commits,
-  with a concise and descriptive message. One commit means one
-  feature/bugfix/thing that has changed, or a diff bringing the code one
-  step forward to a better, working state.
+- Squash your commits together in one or a few complete, logical commits with a concise and descriptive message. One commit means one
+  feature/bugfix/thing that has changed or a diff bringing the code one step forward to a better, working state.

docs/docs/code-of-conduct.mdx

@@ -6,7 +6,7 @@ title: Code of conduct
 
 ## Our Pledge
 
-We as members, contributors, and leaders pledge to make participation in our
+We, as members, contributors, and leaders, pledge to make participation in our
 community a harassment-free experience for everyone, regardless of age, body
 size, visible or invisible disability, ethnicity, sex characteristics, gender
 identity and expression, level of experience, education, socio-economic status,
@@ -19,14 +19,14 @@ diverse, inclusive, and healthy community.
 ## Our Standards
 
 Examples of behavior that contributes to a positive environment for our
-community include:
+community includes:
 
 - Demonstrating empathy and kindness toward other people
 - Being respectful of differing opinions, viewpoints, and experiences
 - Giving and gracefully accepting constructive feedback
 - Accepting responsibility and apologizing to those affected by our mistakes,
   and learning from the experience
-- Focusing on what is best not just for us as individuals, but for the
+- Focusing on what is best not just for us as individuals; but for the
   overall community
 
 Examples of unacceptable behavior include:
@@ -36,7 +36,7 @@ Examples of unacceptable behavior include:
 - Trolling, insulting or derogatory comments, and personal or political attacks
 - Public or private harassment
 - Publishing others' private information, such as a physical or email
-  address, without their explicit permission
+  address without their explicit permission
 - Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
@@ -54,10 +54,10 @@ decisions when appropriate.
 
 ## Scope
 
-This Code of Conduct applies within all community spaces, and also applies when
+This Code of Conduct applies within all community spaces and also applies when
 an individual is officially representing the community in public spaces.
 Examples of representing our community include using an official e-mail address,
-posting via an official social media account, or acting as an appointed
+posting via an official social media account or acting as an appointed
 representative at an online or offline event.
 
 ## Enforcement

docs/docs/demos/email.mdx

@@ -1,7 +1,7 @@
 ---
 id: email-contact
 title: Custom Rendering and Validation
-description: This demonstrates two main things, (1) custom item and option rendering, and (2) item creation on-the-fly. Try typing a valid and invalid email address.
+description: This demonstrates two main things, (1) custom item and option rendering and (2) item creation on-the-fly. Try typing a valid and invalid email address.
 ---
 
 import EmailContact from '@site/src/components/Examples/EmailContact';

docs/docs/glossary.mdx

@@ -1,8 +1,8 @@
 ---
 ---
 
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # Getting Started with Selectize
 
@@ -12,7 +12,7 @@ Selectize is a JavaScript library that provides a rich user experience for selec
 
 ### What you'll need
 
-Selectize requires jQuery. We also include styles for bootstrap, but also provide raw Less and Sass files for you to customize with any framework you like.
+Selectize requires jQuery. We also include styles for bootstrap and provide raw Less and Sass files for you to customize with any framework you like.
 
 If you want to use the Drag & Drop plugin, you'll need jQuery UI.
 
@@ -37,23 +37,20 @@ yarn add @selectize/selectize
 
 ### Install with cdn
 
-The fastest way to add Selectize into your project is to just include the js and css from jsDelivr.
+The fastest way to add Selectize to your project is to include the js and css from [cdnjs](https://cdnjs.com/libraries/selectize.js).
 
 ```html
-<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/selectize.js/0.14.0/css/selectize.css" integrity="sha512-ikoGg2i+6jXI1u0qXylbyIb+9f9/z/fVQR4kor0Dmt3oTIb/ZnOZ33POmdUitzXTDrd5XCpQUhsiXnl/oTuiHA==" crossorigin="anonymous" referrerpolicy="no-referrer" />
-<script src="https://cdnjs.cloudflare.com/ajax/libs/selectize.js/0.14.0/js/standalone/selectize.min.js" integrity="sha512-EZjqrrnoamnlzX1VpHSu7mCYXpbVJdqeJBbpPIHdfH/AtF8Lp/jKrCzYqzKSuVjxriFkEWR0I3qoT2evvrvRmw==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
-```
-
-## Usage
-
-In its simplest form, Selectize can be initialized on an existing `<select>` element:
-
-```html
-<script type="text/javascript" src="selectize.js"></script>
-<link rel="stylesheet" type="text/css" href="selectize.css" />
-<script>
-  $(function () {
-    $("select").selectize(options);
-  });
-</script>
+<link
+  rel="stylesheet"
+  href="https://cdnjs.cloudflare.com/ajax/libs/selectize.js/0.15.2/css/selectize.default.min.css"
+  integrity="sha512-pTaEn+6gF1IeWv3W1+7X7eM60TFu/agjgoHmYhAfLEU8Phuf6JKiiE8YmsNC0aCgQv4192s4Vai8YZ6VNM6vyQ=="
+  crossorigin="anonymous"
+  referrerpolicy="no-referrer"
+/>
+<script
+  src="https://cdnjs.cloudflare.com/ajax/libs/selectize.js/0.15.2/js/selectize.min.js"
+  integrity="sha512-IOebNkvA/HZjMM7MxL0NYeLYEalloZ8ckak+NDtOViP7oiYzG5vn6WVXyrJDiJPhl4yRdmNAG49iuLmhkUdVsQ=="
+  crossorigin="anonymous"
+  referrerpolicy="no-referrer"
+></script>
 ```

docs/docs/intro.mdx

@@ -4,6 +4,6 @@ title: Restore on Backspace
 description: Press the [backspace] key and go back to editing the item without it being fully removed.
 ---
 
-import RestoreBacspace from '@site/src/components/Examples/Plugins/RestoreBacspace';
+import RestoreBackspace from '@site/src/components/Examples/Plugins/RestoreBackspace';
 
-<RestoreBacspace />
+<RestoreBackspace />