Skip to content

Commit e743abd

Browse files
update, fix: Improving and fixing the README.md
- Added Icons wherever necessary. - Made the typos better. - Improved the structure of the README.md file. - Made it clear, concise, precise and to the point. - Added more information on writing README.md for the project.
1 parent 123623a commit e743abd

File tree

1 file changed

+73
-59
lines changed

1 file changed

+73
-59
lines changed

README.md

+73-59
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,28 @@
1-
# <p align="center">Welcome to the JavaScript Mini Projects</p>
1+
# <p align="center">JavaScript Mini Projects 🚀</p>
22

33
<p align="center">
4-
<a href="https://github.com/thinkswell/javascript-mini-projects/blob/master/LICENSE" target="blank">
5-
<img src="https://img.shields.io/github/license/thinkswell/javascript-mini-projects?style=for-the-badge&logo=appveyor" alt="License" />
6-
</a>
7-
<a href="https://github.com/thinkswell/javascript-mini-projects/fork" target="blank">
8-
<img src="https://img.shields.io/github/forks/thinkswell/javascript-mini-projects?style=for-the-badge&logo=appveyor" alt="Forks"/>
9-
</a>
10-
<a href="https://github.com/thinkswell/javascript-mini-projects/stargazers" target="blank">
11-
<img src="https://img.shields.io/github/stars/thinkswell/javascript-mini-projects?style=for-the-badge&logo=appveyor" alt="Star"/>
12-
</a>
13-
<a href="https://github.com/thinkswell/javascript-mini-projects/issues" target="blank">
14-
<img src="https://img.shields.io/github/issues/thinkswell/javascript-mini-projects.svg?style=for-the-badge&logo=appveyor" alt="Issue"/>
15-
</a>
16-
<a href="https://github.com/thinkswell/javascript-mini-projects/pulls" target="blank">
17-
<img src="https://img.shields.io/github/issues-pr/thinkswell/javascript-mini-projects.svg?style=for-the-badge&logo=appveyor" alt="Open Pull Request"/>
18-
</a>
19-
</p>
20-
21-
## Description 🚀
22-
23-
Explore a diverse range of projects that showcase the capabilities of JavaScript. Whether you're just starting your coding journey or have been in the field for a while, there's something here for everyone. It's not about fancy titles; it's about the joy of coding in JavaScript. Dive in, explore the code, and let the love for coding and learning flow! Thank you for contributing to this collaborative space. Happy coding! 🌟"
24-
25-
## IMPORTANT!!! Setting up the Frontend to Showcase All the Projects
4+
<a href="https://github.com/thinkswell/javascript-mini-projects/blob/master/LICENSE" target="_blank">
5+
<img src="https://img.shields.io/github/license/thinkswell/javascript-mini-projects?style=for-the-badge&logo=appveyor" alt="License" />
6+
</a>
7+
<a href="https://github.com/thinkswell/javascript-mini-projects/fork" target="_blank">
8+
<img src="https://img.shields.io/github/forks/thinkswell/javascript-mini-projects?style=for-the-badge&logo=appveyor" alt="Forks" />
9+
</a>
10+
<a href="https://github.com/thinkswell/javascript-mini-projects/stargazers" target="blank">
11+
<img src="https://img.shields.io/github/stars/thinkswell/javascript-mini-projects?style=for-the-badge&logo=appveyor" alt="Stars" />
12+
</a>
13+
<a href="https://github.com/thinkswell/javascript-mini-projects/issues" target="blank">
14+
<img src="https://img.shields.io/github/issues/thinkswell/javascript-mini-projects.svg?style=for-the-badge&logo=appveyor" alt="Issues" />
15+
</a>
16+
<a href="https://github.com/thinkswell/javascript-mini-projects/pulls" target="blank">
17+
<img src="https://img.shields.io/github/issues-pr/thinkswell/javascript-mini-projects.svg?style=for-the-badge&logo=appveyor" alt="Open Pull Requests" />
18+
</a>
19+
</p>
20+
21+
<p align="center">Explore a diverse range of projects that showcase the capabilities of JavaScript. Whether you're just starting your coding journey or have been in the field for a while, there's something here for everyone. It's not about fancy titles; it's about the joy of coding in JavaScript. Dive in, explore the code, and let the love for coding and learning flow! Thank you for contributing to this collaborative space. Happy coding! 🌟</p>
22+
23+
## 🚀 Getting Started with the Frontend
24+
25+
**IMPORTANT! Setting up the Frontend to Showcase All the Projects**
2626

2727
Dear contributors,
2828

@@ -56,109 +56,123 @@ We have established the "1Application-frontend" directory at the top of the repo
5656
npm run dev
5757
```
5858

59-
<h3 align="left">Languages and Tools:</h3>
60-
<p align="left"> <a href="https://www.cprogramming.com/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/c/c-original.svg" alt="c" width="40" height="40"/> </a> <a href="https://www.w3schools.com/cpp/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/cplusplus/cplusplus-original.svg" alt="cplusplus" width="40" height="40"/> </a> <a href="https://www.w3schools.com/css/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/css3/css3-original-wordmark.svg" alt="css3" width="40" height="40"/> </a> <a href="https://expressjs.com" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/express/express-original-wordmark.svg" alt="express" width="40" height="40"/> </a> <a href="https://www.figma.com/" target="_blank" rel="noreferrer"> <img src="https://www.vectorlogo.zone/logos/figma/figma-icon.svg" alt="figma" width="40" height="40"/> </a> <a href="https://www.framer.com/" target="_blank" rel="noreferrer"> <img src="https://www.vectorlogo.zone/logos/framer/framer-icon.svg" alt="framer" width="40" height="40"/> </a> <a href="https://git-scm.com/" target="_blank" rel="noreferrer"> <img src="https://www.vectorlogo.zone/logos/git-scm/git-scm-icon.svg" alt="git" width="40" height="40"/> </a> <a href="https://www.w3.org/html/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/html5/html5-original-wordmark.svg" alt="html5" width="40" height="40"/> </a> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/javascript/javascript-original.svg" alt="javascript" width="40" height="40"/> </a> <a href="https://www.linux.org/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/linux/linux-original.svg" alt="linux" width="40" height="40"/> </a> <a href="https://www.mongodb.com/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/mongodb/mongodb-original-wordmark.svg" alt="mongodb" width="40" height="40"/> </a> <a href="https://www.mysql.com/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/mysql/mysql-original-wordmark.svg" alt="mysql" width="40" height="40"/> </a> <a href="https://nodejs.org" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/nodejs/nodejs-original-wordmark.svg" alt="nodejs" width="40" height="40"/> </a> <a href="https://reactjs.org/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/react/react-original-wordmark.svg" alt="react" width="40" height="40"/> </a> <a href="https://reactnative.dev/" target="_blank" rel="noreferrer"> <img src="https://reactnative.dev/img/header_logo.svg" alt="reactnative" width="40" height="40"/> </a> <a href="https://redux.js.org" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/redux/redux-original.svg" alt="redux" width="40" height="40"/> </a> <a href="https://sass-lang.com" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/sass/sass-original.svg" alt="sass" width="40" height="40"/> </a> <a href="https://tailwindcss.com/" target="_blank" rel="noreferrer"> <img src="https://www.vectorlogo.zone/logos/tailwindcss/tailwindcss-icon.svg" alt="tailwind" width="40" height="40"/> </a> <a href="https://www.typescriptlang.org/" target="_blank" rel="noreferrer"> <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/typescript/typescript-original.svg" alt="typescript" width="40" height="40"/> </a> </p>
59+
## 🛠️ Languages and Tools
6160

62-
## How to Contribute
61+
<p align="left">
62+
<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript" target="_blank" rel="noreferrer">
63+
<img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/javascript/javascript-original.svg" alt="javascript" width="40" height="40" />
64+
</a>
65+
<!-- Add more relevant icons as needed -->
66+
</p>
6367

64-
Make some awesome projects, put them in your directory and create a pull request. and DONE ✅
68+
## 🤝 How to Contribute
6569

66-
### Steps to Raise and get your PR Merged successfully.
70+
Contribute to this repository by adding your awesome JavaScript projects. Here's how:
6771

68-
1. Fork this repository
72+
### Steps to Raise and Get Your PR Merged Successfully
6973

70-
2. Clone the repository into your local system
74+
1. Fork this repository.
75+
76+
2. Clone the repository into your local system:
7177

7278
```bash
7379
git clone https://github.com/<username>/javascript-mini-projects.git
7480
```
7581

76-
3. Create a branch `projectname-username`, e.g. - `git checkout -b ChatApp-thinkswell`
82+
3. Create a branch `projectname-username`, e.g. - `git checkout -b ChatApp-thinkswell`:
7783

7884
```bash
7985
git checkout -b ChatApp-thinkswell
8086
```
8187

82-
4. Add your projects in the respective directory (if exist otherwise create one), the name of directory should be your `ProjectName/USERNAME`.
88+
4. Add your projects in the respective directory (if it exists; otherwise, create one). The directory name should be your `ProjectName/USERNAME`.
8389

8490
Examples: `ChatApp/thinkswell`
85-
Use of PascalCase is necessary for the naming of directory.
8691

87-
5. **Add `One project` at a time**
92+
Use PascalCase for the naming of the directory.
93+
94+
5. **Add one project at a time.**
95+
96+
6. **Important! Make sure to add a README.md to your project directory**:
97+
98+
- For developers, include what framework, library, language you have used.
99+
- Include the steps to run the project on a local machine.
100+
- If you have used any API, mention how to get the API key and how to use it.
101+
- If you have a live demo of your project, provide a link in the README.md file.
102+
- For non-developers, describe the features of your project and how to use it.
103+
- **Include a screenshot of your working project.**
88104

89-
6. **Add & commit**
105+
6. **Add & commit**:
90106

91107
```bash
92108
git add -A
93-
git commit -m "Your commit message about project"
109+
git commit -m "Your commit message about the project"
94110
```
95111

96-
7. **Push changes to GitHub**,
112+
7. **Push changes to GitHub**:
97113

98114
```bash
99115
git push origin ChatApp-thinkswell
100116
```
101117

102118
8. **Click** on `Create a Pull Request`.
103119

104-
9. Attach some **SCREENSHOTS/GIF** or **link of your working project** in the description _**❗Important❗**_.
120+
9. Attach **SCREENSHOTS/GIFs** or a **link to your working project** in the description _**❗Important❗**_.
105121

106122
10. **Submit** the PR.
107123

108-
11. **Leave a ⭐ to the repo and `FOLLOW` me if you liked the project.**
124+
11. **Leave a ⭐ on the repo and `FOLLOW` if you liked the project.**
109125

110-
---
111-
112-
### What You Can Contribute
126+
## 🌟 What You Can Contribute
113127

114128
We welcome contributions from the community to enhance and expand our collection of mini JavaScript projects. Here are several ways you can contribute:
115129

116-
👉 **Add New Projects**
130+
👉 **Add New Projects**:
117131

118132
Do you have a creative JavaScript project that you think would be a great addition to our collection? Submit your project!
119133

120-
👉 **Bug Fixes**
134+
👉 **Bug Fixes**:
121135

122136
If you find any issues or bugs in existing projects, please report them by creating an issue. Better yet, submit a pull request with a fix!
123137

124-
👉 **Create Issues**
138+
👉 **Create Issues**:
125139

126-
Have an idea for a new project? Create a new issue by clicking on the `New Issue` button and updating the pre-defined template.
140+
Have an idea for a new project
127141

128-
We're happy to merge awesome portfolio to this repository!
142+
? Create a new issue by clicking on the `New Issue` button and updating the pre-defined template.
129143

130-
---
144+
We're happy to merge awesome portfolios into this repository!
131145

132-
## Usage
146+
## 🚀 Usage
133147

134148
This repository contains a collection of mini JavaScript projects, each designed to demonstrate a specific concept or feature. Here's how you can use these projects:
135149

136-
👉 **Choose a project**
150+
👉 **Choose a Project**:
137151

138152
Browse the repository to find a project that interests you. Each project is contained within its own folder.
139153

140-
👉 **Clone the repository**
154+
👉 **Clone the Repository**:
141155

142156
Clone this repository to your local machine.
143157

144-
👉 **Navigate to the project folder**
158+
👉 **Navigate to the Project Folder**:
145159

146-
Change directory to the specific project you want to explore.
160+
Change the directory to the specific project you want to explore.
147161

148-
👉 **Open index.html or index.js in your browser**
162+
👉 **Open index.html or index.js in Your Browser**:
149163

150164
Most projects include an index.html or index.js file. Open this file in your web browser to interact with the project.
151165

152-
👉 **Explore and interact**
166+
👉 **Explore and Interact**:
153167

154168
Have fun with the project!
155169

156-
---
157-
158-
## Disclaimer
170+
## ⚠️ Disclaimer
159171

160172
We are deeply committed to fostering genuine open-source contributions. Consequently, we maintain a strict policy against the use of plagiarized source code. Any Pull Requests (PRs) that do not adhere to our Terms and Conditions will be identified as spam and subsequently closed by our maintainers.
161173

162174
Please be aware that we do not accept responsibility for any potential damages resulting from the scripts or programs included in this repository. These projects are publicly curated and do not undergo stringent malware or virus checks. Therefore, neither the maintainers nor the owner of this repository can be held accountable for any issues arising from running any of the programs or applications found within this repository.
163175

164-
## <p align="center">Hurray! Now you are a part of the open source community 🚀🚀🚀</p>
176+
##### <p align="center">Hurray! Now you are a part of the open-source community 🚀🚀🚀</p>
177+
178+
---

0 commit comments

Comments
 (0)