-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #21 from mehedikhan72/playing-with-ci-cd
readme n development update
- Loading branch information
Showing
2 changed files
with
67 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
# Greetings! | ||
|
||
It's great to see you being interested in contributing to the project! | ||
|
||
#### Here are some steps to get you started: | ||
|
||
## Contributing to the project | ||
|
||
* Fork the repository | ||
* Clone the repository | ||
* Create a new branch | ||
* Make your changes | ||
* Commit your changes with a descriptive commit message and push your commit to your fork. | ||
* Create a pull request. Please provide a detailed description of your changes and why you think they should be merged. | ||
* Wait for your pull request to be reviewed and merged! | ||
|
||
## We would appreciate | ||
|
||
* If you are patient and respectful in your interactions with other contributors. | ||
* If you are open to feedback and constructive criticism. | ||
|
||
## How to run the project locally | ||
|
||
Run a postgresql database on your local machine, with the following credentials: | ||
|
||
``` | ||
POSTGRES_USER=postgres | ||
POSTGRES_PASSWORD=postgres | ||
POSTGRES_DB=pathfinder | ||
``` | ||
|
||
After you have cloned the repository, navigate to the project directory and run the following command: | ||
|
||
``` | ||
./start-dev.sh | ||
``` | ||
|
||
This script copies the necessary environment variables from '.env.prototype' | ||
into a new '.env' file and starts the development server. | ||
|
||
#### Voila! The development server should be running at [localhost:8080](http://localhost:8080). | ||
|
||
## API documentation | ||
|
||
If you're running the server locally, you should be able to access the API documentation | ||
at [here](http://localhost:8080/swagger-ui/index.html). | ||
|
||
## I'm new! What issues do I begin with? | ||
|
||
Head over to the [issues](https://github.com/mehedikhan72/pathfinder-api/issues) tab and look for issues with the label `good first issue`. | ||
These issues are beginner-friendly and are a great way to get started with contributing to the project. | ||
|
||
#### Checkstyle is a great tool to ensure that your code is clean and follows the project's style guide. Unfortunately, it was introduced after the project was started, so there are a lot of violations in the codebase. If you're looking for a simple way to contribute, fixing these violations is a great way to start! | ||
|
||
Run the following command to check for violations in your code: | ||
|
||
``` | ||
mvn checkstyle:check | ||
``` | ||
|
||
Head over to checktyle's [documentation](https://checkstyle.sourceforge.io/) to learn more about the tool and how to fix | ||
violations. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,5 @@ | ||
## Welcome to the readme section of pathFinder API. | ||
# pathFinder | ||
#### Your gateway to knowledge! Designed to connect curious minds with seasoned pros, pathFinder transforms career aspirations into achievable goals. Explore, connect, and thrive with mentors who illuminate your path to success. | ||
|
||
API documentation can be found [here](http://localhost:8080/swagger-ui/index.html). | ||
## Contributions | ||
#### If you're looking to contribute to the project, please visit [here](https://github.com/mehedikhan72/pathfinder-api/blob/master/DEVELOPMENT.md) for more information. |