Skip to content

Commit 6e245c4

Browse files
committed
feat: add init README
1 parent 9546ddb commit 6e245c4

1 file changed

Lines changed: 72 additions & 1 deletion

File tree

README.md

Lines changed: 72 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,72 @@
1-
# dictionry
1+
<div align="center" style="margin-top: 12px">
2+
<a href="https://www.jargons.dev">
3+
<img width="500" alt="jargons.dev" src="https://github.com/babblebey/jargons.dev/assets/25631971/f2adedb8-4324-439a-8663-d3e30fd68416">
4+
</a>
5+
6+
<h1><tt>jargons.dev</tt></h1>
7+
<h3>The Software Engineering Dictionary</h3>
8+
</div>
9+
10+
## About
11+
12+
<tt>jargons.dev</tt> is an open source dictionary curated by contributors providing simplified meaning and definitions to software development, engineering, and general technology terms.
13+
14+
## Tech Stack
15+
16+
<tt>jargons.dev</tt> is built using the following open source technologies:
17+
18+
- [Astro](https://astro.build/) - Web framework for building content-driven websites
19+
- [React](https://react.dev) - Library for building web interfaces
20+
- [Tailwind CSS](https://tailwindcss.com) - A Utility-first CSS Library
21+
22+
## Run Project Locally
23+
24+
To run the project locally running on your machine, follow these simple steps.
25+
26+
### Prerequisite
27+
28+
To run the project locally, ensure your machine has **Node.js** installed. The project requires **Node.js** version 19 or higher. If you don't have **Node.js** installed, you can download it from the [Node.js website](https://nodejs.org/).
29+
30+
### Setup
31+
32+
To get set-up follow these steps:
33+
34+
1. Clone the repository:
35+
36+
```sh
37+
git clone https://github.com/babblebey/jargons.dev.git
38+
```
39+
40+
2. Navigate to the project directory:
41+
42+
```sh
43+
cd jargons.dev
44+
```
45+
46+
3. Install dependencies:
47+
48+
```sh
49+
npm ci
50+
```
51+
52+
4. Run set scripts........[wip]
53+
54+
5. Start the development server:
55+
56+
```sh
57+
npm start
58+
```
59+
60+
6. Open your browser and visit `http://localhost:4321` to view the project.
61+
62+
## Contributing
63+
64+
We welcome contributions to jargons.dev! There are two main ways you can contribute to:
65+
66+
1. **Dictionary Word Contribution:**
67+
This includes adding new words to the dictionary or editing existing word entries. We highly recommend using our Jargons Editor at [jargons.dev/editor](https://jargons.dev/editor) for this purpose. This user-friendly interface ensures your contribution ends up as a pull request seamlessly.
68+
69+
2. **Other Contributions:**
70+
Theses are contributions other than adding or editing words in the dictionary, feel free to contribute in other ways such as code improvements, bug fixes, or feature enhancements.
71+
72+
To get started with contributing, please refer to our [Contribution Guide](./CONTRIBUTING.md). Thank you for contributing to the jargons.dev project!

0 commit comments

Comments
 (0)