|
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