simplified docs and prevent workflow from running incorrectly in other people's repo

README.md

@@ -1,69 +1,54 @@
 # developomp-site
 
-[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](./LICENSE)
-[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)](./LICENSE)
 
 Source code for my (developomp's) <a href="https://developomp.com" target="_blank">website</a>.
 
-# Setup
+## Setup
 
-Requirements:
+### Requirements
 
--   [node](https://nodejs.org)
+-   [nodeJS](https://nodejs.org)
 -   [yarn](https://github.com/yarnpkg/yarn)
--   optional:
-    -   [vscode](https://code.visualstudio.com)
-        -   [extensions](./.vscode/extensions.json) (also optional but highly recommended)
 
-Steps:
+### Steps
 
--   Clone this repository
+#### 1. Clone this repository
 
-    `git clone https://github.com/developomp/developomp-site.git`
+```bash
+git clone https://github.com/developomp/developomp-site.git
+```
 
--   Or download as a zip file
+#### 2. Open the [`source`](./source) directory
 
-    ![download procedure](./downloading.png)
+```bash
+cd source
+```
 
--   open [`source`](./source) directory
+#### 3. Install dependencies
 
-    `cd source`
+```bash
+yarn install
+```
 
--   Install dependencies (must be in `source` directory)
+#### 4. Test locally
 
-    `yarn install`
+```bash
+yarn start
+```
 
--   start local server in http://localhost:3000
-
-    `yarn start`
-
-# Contributing
-
-Please read the [`CONTRIBUTING.md`](./CONTRIBUTING.md) file.
-
-# How it works
-
-> Check the comments [`generator.ts`](./source/generate.ts) file for more detailed information.
-
-When you run the `yarn start` command, the project executes the [generate.ts](./source/generate.ts) script before starting the app. This script converts [markdown files](./source/markdown) to json files so it can be imported by react on the frontend.
-
-To perform the conversion without starting the app, run `yarn generate` command.
-
-To start the app without generating json files, run `yarn quick-start` command.
-
-# Special thanks
+## Special thanks
 
+-   My dear friend [Aditya Prakash](https://github.com/AdityaPrakash-26) for extensive testing and wonderful suggestions
 -   [Ruipeng Zhang](https://github.com/ppoffice) for design inspiration ([hexo-icarus-theme](https://github.com/ppoffice/hexo-theme-icarus))
 -   [Artem Golubin](https://github.com/rushter) for design inspiration ([his blog](https://rushter.com/blog))
 -   [discord](http://discord.com) for dark theme color palette (before the [rebranding of May 2021](https://blog.discord.com/how-were-making-discord-more-welcoming-for-everyone-ee152f198c60))
--   My dear friend [Aditya Prakash](https://github.com/AdityaPrakash-26) for extensive testing and wonderful suggestions
 
-# License
+## License
 
-This project is licensed under the MIT License.<br>
-Check the [LICENSE](./LICENSE) file for more information.
+The source code for this project is available under the [MIT License](./LICENSE).<br>
 
-Font license:
+Font licenses:
 
 [Open Font License (OFL)](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL#5667e9e4):