diff --git a/.gitignore b/.gitignore
index 5c377558..8e9679bb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,3 +5,6 @@ client/.env
server/node_modules
server/.env
+
+.DS_Store
+client/.DS_Store
\ No newline at end of file
diff --git a/README.md b/README.md
index 9855d39d..3ddbc998 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-
+
[](#contributors-)
@@ -24,7 +24,7 @@
### [Download Chrome Extension](https://chrome.google.com/webstore/detail/letra/cjodkkjokggcaeacdhjliobekbnnmoio)
-
+
## ✨ Features
- New word everyday
@@ -47,15 +47,17 @@
## 🤝 Contributing
-Contributions, issues and feature requests are welcome!
Feel free to check the [issues page](https://github.com/jayehernandez/letra-extension/issues) for any open issues.
+Contributions, issues and feature requests are welcome!
+
+Feel free to check the [issues page](https://github.com/jayehernandez/letra-extension/issues) for any open issues. If this is your first time contributing to Open Source, check out the [Contributing Guidelines](https://github.com/jayehernandez/letra-extension/blob/improved-docs/docs/how_to_contribute.md).
You can also suggest a new feature by creating an Issue. Please wait for confirmation before working on it.
### Good for First Timers
+- [Add a learning quote](https://github.com/jayehernandez/letra-extension/blob/master/docs/new_quote.md) (Easiest way to contribute! 🚀)
- [Add a new language](https://github.com/jayehernandez/letra-extension/blob/master/docs/new_language.md)
- Edit translations from existing languages - guide 🔜
-- Add a learning quote - guide 🔜
## 🙏🏻 Acknowledgements
@@ -89,7 +91,6 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
-
## 📝 License
Copyright © 2020 [Jaye Hernandez](https://github.com/jayehernandez).
diff --git a/docs/how_to_contribute.md b/docs/how_to_contribute.md
new file mode 100644
index 00000000..75724857
--- /dev/null
+++ b/docs/how_to_contribute.md
@@ -0,0 +1,51 @@
+# 🗒 What the Fork? (Contributing Guidelines)
+
+> A simple guide on how to contribute to this project, from start to end! Also did you get the pun? I love The Good Place.
+
+Is this your first time contributing to open source? No worries, here's a simple guide to help you out! If you get stuck on a step, please don't hesitate to ask me. :)
+
+You can contribute in two ways, whichever is more convinient for you:
+1. Via Github Website _(no need to download anything!)_
+2. Via Local Machine
+
+## 1️⃣ Via Github Website
+1. Check the **Issues page** to choose what you want to contribute on!
+
+2. Click on **Fork** on the upper right hand of the screen.
+
+
+
+> ☁️ Forking a Repository allows you to have your own copy of the repository. This is the best practice for contributing to open source projects.
+
+3. Once the repo is forked, you'll be redirected to the newly created repository. You should see **forked from jayehernandez / letra-extension**.
+
+
+4. You can now make changes to this repository, depending on what issues you chose to take on. 👩🏻💻👨🏻💻
+
+5. When you're finished which the changes, you'll see that your repository is ahead of some commits from the main repository. Click on **Pull Request** to start creating a pull request (PR).
+
+
+
+> ☁️ Pull Requests allow maintainers of a project to review your code and merge it to the main repository afterwards.
+
+6. You'll be able to choose which branch you'd like to compare with. Make sure you choose the **develop** branch.
+
+
+
+> ☁️ Pull Requests pointing to master will not be accepted. The master branch is all the code that is currently published in the Chrome Web Store.
+
+7. After selecting the correct branch, you'll be able to click on **Create pull request**.
+
+
+
+8. You'll be able to edit the title and description of your pull request before actually creating the pull request. If you are referencing an open issue, please reference it here.
+
+
+
+9. Hooray! You successfully created a PR for Letra! I'll be reviewing the changes you created and if everything is okay, your changes will be merged. 🥳
+
+
+
+## 2️⃣ Via Local Machine
+
+🚧 Guide coming soon! 🔜
diff --git a/docs/new_quote.md b/docs/new_quote.md
new file mode 100644
index 00000000..ca519bb2
--- /dev/null
+++ b/docs/new_quote.md
@@ -0,0 +1,28 @@
+# ➕ Adding Quotes
+
+> No need for experience in VueJS and NodeJS is needed to add a new language. **You'll only be working with JSON files 🎉**
+
+## 📝 Guidelines
+
+### Where is this seen?
+
+
+This is seen below the word of the day. This is randomized so that you'll get a different quote each day! It's meant to serve as an inspiration for language learning.
+
+### Adding Quote
+You'll need to add the new quote in the `server/data/quotes.json` file.
+
+Example:
+```sh
+{
+ "sentence": "Languages, just like people, are worlds within themselves. They have the incredible ability to provide us with a clearer, more profound and detailed perspective of a culture and its views on life, nature, and death.",
+ "author": "Orge Castellano"
+}
+```
+
+Here's a small checklist to make sure your Pull Request is accepted!
+
+## ✅ Checklist
+- [ ] The quote(s) added are not ❌ duplicates.
+- [ ] The sentence attribute does not have inner quotation marks, and is ended with a period.
+- [ ] Copy pasted the raw JSON `quotes.json` file to [JSONLint](https://jsonlint.com/) and made sure that the modified JSON file is valid.
diff --git a/docs/screenshots/branch_ahead.png b/docs/screenshots/branch_ahead.png
new file mode 100644
index 00000000..1462a4a1
Binary files /dev/null and b/docs/screenshots/branch_ahead.png differ
diff --git a/docs/screenshots/choose_branch.png b/docs/screenshots/choose_branch.png
new file mode 100644
index 00000000..a7a9a005
Binary files /dev/null and b/docs/screenshots/choose_branch.png differ
diff --git a/docs/screenshots/commit_changes.png b/docs/screenshots/commit_changes.png
new file mode 100644
index 00000000..680bc11f
Binary files /dev/null and b/docs/screenshots/commit_changes.png differ
diff --git a/docs/screenshots/correct_branch.png b/docs/screenshots/correct_branch.png
new file mode 100644
index 00000000..d245890e
Binary files /dev/null and b/docs/screenshots/correct_branch.png differ
diff --git a/docs/screenshots/create_pr.png b/docs/screenshots/create_pr.png
new file mode 100644
index 00000000..3a13730a
Binary files /dev/null and b/docs/screenshots/create_pr.png differ
diff --git a/docs/screenshots/created_pr.png b/docs/screenshots/created_pr.png
new file mode 100644
index 00000000..783a6dc1
Binary files /dev/null and b/docs/screenshots/created_pr.png differ
diff --git a/docs/screenshots/edit_file.png b/docs/screenshots/edit_file.png
new file mode 100644
index 00000000..19b56d1e
Binary files /dev/null and b/docs/screenshots/edit_file.png differ
diff --git a/docs/screenshots/fork.png b/docs/screenshots/fork.png
new file mode 100644
index 00000000..d2dd7e59
Binary files /dev/null and b/docs/screenshots/fork.png differ
diff --git a/docs/screenshots/forked_repository_name.png b/docs/screenshots/forked_repository_name.png
new file mode 100644
index 00000000..93b96541
Binary files /dev/null and b/docs/screenshots/forked_repository_name.png differ
diff --git a/docs/screenshots/forking.png b/docs/screenshots/forking.png
new file mode 100644
index 00000000..1fe0229d
Binary files /dev/null and b/docs/screenshots/forking.png differ
diff --git a/docs/main_screenshot.png b/docs/screenshots/main_screenshot.png
similarity index 100%
rename from docs/main_screenshot.png
rename to docs/screenshots/main_screenshot.png
diff --git a/docs/title.png b/docs/screenshots/title.png
similarity index 100%
rename from docs/title.png
rename to docs/screenshots/title.png