docs: formatting, better contributing docs

Signed-off-by: Florian-Schoenherr <[email protected]>

Author: Florian-Schoenherr

packages/docs/src/routes/getting-started/contributing.md

@@ -18,16 +18,17 @@ Before reporting an issue, ensure that you:
 
 - have tried providing a [REPL](https://svelte.dev/repl/9982308600f043f3aeb43fb3b17f35b5?version=3.37.0)
 
-## Setting up your environment
+## Working on Svelte Materialify
+### Setting up your environment
 
 Follow these instructions if you are planning to make a pull request.
 
-## Getting the source
+### Getting the source
 
 1.  Register to [Github](https://github.com/)
 2.  Navigate to [svelte-materialify](https://github.com/TheComputerM/svelte-materialify)
 3.  Press the fork button in the top right corner of the screen
-4.  Copy the url of your browser, it should now be: https://github.com/**your_github_user_id**/svelte-materialify
+4.  Copy the url of your browser, it should now be: `https://github.com/{your_github_user_id}/svelte-materialify`
 5.  On your PC, open a command prompt window and type the following commands
 
 ```shell
@@ -37,7 +38,7 @@ $ cd svelte-materialify
 
 This will get the entire repository on your machine, now we can build the library.
 
-## Building
+### Building
 
 Building is done with yarn (**not** npm).
 From the **root folder**, install the dependencies by typing:
@@ -64,12 +65,21 @@ To build the API, which provides the definitions and types for the different pro
 yarn api
 ```
 
-## Submitting your change
+### Submitting your change
 
-After making a change, make sure it works well by running `yarn lint` and `yarn test`, then commit your changes following [conventional commit syntax](https://github.com/conventional-changelog/commitlint/#what-is-commitlint).
+After making a change, make sure it works well by running:
+```shell
+yarn lint
+```
+and
+```shell
+yarn test
+```
+Please commit your changes following [conventional commit syntax](https://github.com/conventional-changelog/commitlint/#what-is-commitlint), for example:
+```shell
+git commit -m "docs: improve contributing.md"
+```
 
-For example:
-`docs: improve contributing.md`
+Then, **git push** your changes to your github repository.
 
-Then, push your changes to your github repository.
-Finally, from the github repository web page, you can click the Pull Request button and a contributor will review the changes you made.
+Finally, from the github repository web page, you can click the **Pull Request** button and a contributor will review the changes you made.

packages/docs/src/routes/getting-started/installation.md

@@ -37,6 +37,7 @@ $ npm i -D svelte-materialify svelte-preprocess sass postcss
 ```
 
 Now create a **\_material-theme.scss** file. Let's put it in a folder called **theme**.
+
 Include the folder path in the `sveltePreprocess` function in your **rollup.config.js**:
 
 ```js

packages/docs/src/routes/getting-started/usage.md

@@ -43,7 +43,7 @@ In your svelte files, import the _uncompiled_ module `from 'svelte-materialify/s
 ```
 ## Layout
 
-All components should be children of `MaterialApp`, which has all the **global styles** and enables theming:
+All components should be children of `MaterialApp`, which provides all the **global styles** and enables theming:
 
 ```html
 <script>
@@ -71,7 +71,8 @@ If you don't want any global styles (other than theming and colors), you can use
 
 ## Theming
 
-You want to customise some SCSS variables? Worry not, just put them in the **\_material-theme.scss** you had created:
+You want to customise some SCSS variables?
+Worry not, just put them in the **\_material-theme.scss** you had created:
 
 ```scss
 $primary-color: #004d26;
@@ -93,6 +94,6 @@ To access these variables in your own components, just import the variable file
 
 <Components.Alert type='info'>
 
-If you want to use SCSS and SASS styles in your own components, [use svelte-preprocess](https://github.com/sveltejs/svelte-preprocess/blob/master/docs/usage.md).
+If you want to use SCSS and SASS styles in your own components, [use svelte-preprocess](https://github.com/sveltejs/svelte-preprocess/blob/main/docs/usage.md).
 
 </Components.Alert>