jargons.dev is an open source dictionary curated by contributors providing simplified meaning and definitions to software development, engineering, and general technology terms.
jargons.dev is built using the following open source technologies:
- Astro - Web framework for building content-driven websites
- React - Library for building web interfaces
- Tailwind CSS - A Utility-first CSS Library
To run the project locally running on your machine, follow these simple steps.
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.
To get set-up follow these steps:
-
Clone the repository:
git clone https://github.com/jargonsdev/jargons.dev.git
-
Navigate to the project directory:
cd jargons.dev -
Install dependencies:
npm ci
-
Run the
dev/setupscript and create test repoThis script streamlines the process of creating a GitHub App required to run jargons.dev locally and sets up the environment file (.env) for you; Learn more at dev/setup
npm run setup
-
Start the development server:
npm start
-
Open your browser and visit
http://localhost:4321to view the project.
We welcome contributions to jargons.dev! There are two main ways you can contribute to:
-
Dictionary Word Contribution: This includes adding new words to the dictionary or editing existing word entries. We highly recommend using our Jargons Editor at jargons.dev/editor for this purpose. This user-friendly interface streamlines your contribution allowing it end up as a pull request.
-
Other Contributions: These are contributions other than adding or editing words in the dictionary, feel free to contribute in other ways such as issue reporting/triaging, code/documentation improvements, bug fixes, or feature enhancements.
To get started with contributing, please refer to our Contribution Guide. Thank you for contributing to the jargons.dev project!
Do leave the project a star ⭐️