refactor(README): refine formatting and overhaul content (#26)

* refactor(README): refine formatting and overhaul content

* fix(docs): use correct link for deploy action

---------

Co-authored-by: Daniel Rudnitski <danielrudn@gmail.com>

Author: akbad

README.md

@@ -1,41 +1,35 @@
 # Website
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+## Development
 
-### Installation
+### Adding content
 
-```
-$ yarn
-```
-
-### Local Development
+We use [Docusaurus](https://docusaurus.io/) within these docs.
 
-```
-$ yarn start
-```
+- You can find a [general set of guides to Docusaurus here](https://docusaurus.io/docs/category/guides).
+- **Docusaurus provides extra cool formatting features** on top of vanilla Markdown,
+  see the [guide to these features here](https://docusaurus.io/docs/markdown-features).
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+### Running the server
 
-### Build
+Install deps and run the dev server locally by running:
 
-```
-$ yarn build
+```sh
+yarn
+yarn start
 ```
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
-
-### Deployment
+Most changes are reflected live without having to restart the server.
 
-Using SSH:
+## Building
 
-```
-$ USE_SSH=true yarn deploy
+```sh
+yarn build
 ```
 
-Not using SSH:
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
 
-```
-$ GIT_USER=<Your GitHub username> yarn deploy
-```
+## Deploying
 
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+- Deploying to GitHub Pages occurs automatically upon merges to `main`.
+- Check the [list of all `Deploy to GitHub Pages` workflow runs](https://github.com/ibm-skills-network/portals-admin-knowledgebase/actions/workflows/deploy.yml) to ensure your changes are successfully deployed after they're merged.