Skip to content

Commit 28112c8

Browse files
committed
add contributing guidelines and update readme
Signed-off-by: Aman Dwivedi <[email protected]>
1 parent 9844eca commit 28112c8

File tree

2 files changed

+66
-53
lines changed

2 files changed

+66
-53
lines changed

CONTRIBUTION.md

+36
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# STEPS TO CONTRIBUTE
2+
3+
1. Find an issue to work on or create a new issue at [https://github.com/litmuschaos/litmus-e2e/issues](https://github.com/litmuschaos/litmus-e2e/issues) if you find a bug/suggest a new feature addition/change.
4+
5+
2. Fork the main repository to create a duplicate copy for yourself.
6+
7+
3. Clone the `gh-pages` branch of `litmus-e2e` repository
8+
```
9+
git clone -b gh-pages https://github.com/litmuschaos/litmus-e2e.git
10+
```
11+
12+
4. Create a feature branch in the forked repository and always send a PR from the feature-branch to the `gh-pages` branch of the upstream repository.
13+
14+
```
15+
Example- Aman-Codes/modal-component -> litmus-e2e/gh-pages
16+
```
17+
18+
## PULL REQUEST SPECIFICATIONS
19+
20+
To ensure that your PR is of high quality and to maintain the coding standards there are some best practices which we need to adhere to in order to successfully merge the PRs.
21+
22+
1. While committing the changes please ensure you sign your commits by using -s flag
23+
```
24+
git commit -s -m “<YOUR COMMIT MESSAGE>”
25+
```
26+
27+
2. Please fill in the details of the changes that have been made/modified with the respective PR and also check of the necessary checklist in the PR checklist itself.
28+
29+
3. Always lint your project locally before sending a PR.
30+
```
31+
yarn run format
32+
```
33+
34+
4. Don’t skip husky pre-commit checks as it ensures your code is well formatted and linted as well. Please don’t bypass husky since non-formatted code are very easy to detect.
35+
36+
5. Keep the main repository as an upstream in order to always fetch from the main repository and keep your local branch as updated as possible to not hinder your work.

README.md

+30-53
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,47 @@
1-
# Getting Started with Create React App
1+
# Litmus E2E Dashboard
22

3-
This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).
3+
## Prerequisites
44

5-
## Available Scripts
5+
- Install Yarn globally
66

7-
In the project directory, you can run:
7+
## Setup and Installation
88

9-
### `yarn start`
9+
- Clone the `gh-pages` branch of `litmus-e2e` repository
1010

11-
Runs the app in the development mode.\
12-
Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
11+
```
12+
git clone -b https://github.com/litmuschaos/litmus-e2e.git
13+
```
1314

14-
The page will reload if you make edits.\
15-
You will also see any lint errors in the console.
15+
- Install all the required dependencies with the below command
1616

17-
### `yarn test`
17+
```
18+
yarn install
19+
```
1820

19-
Launches the test runner in the interactive watch mode.\
20-
See the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.
21+
## Run locally
2122

22-
### `yarn build`
23+
Run the below command to start the server:
2324

24-
Builds the app for production to the `build` folder.\
25-
It correctly bundles React in production mode and optimizes the build for the best performance.
25+
```
26+
yarn start
27+
```
2628

27-
The build is minified and the filenames include the hashes.\
28-
Your app is ready to be deployed!
29+
Go to: http://localhost:3000/litmus-e2e/dashboard
30+
## Deployed Link
2931

30-
See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.
32+
Visit the deployed website at https://litmuschaos.github.io/litmus-e2e/dashboard/
3133

32-
### `yarn eject`
34+
## Tech Stack
3335

34-
**Note: this is a one-way operation. Once you `eject`, you can’t go back!**
36+
Litmus E2E Dashboard is built using the following:
3537

36-
If you aren’t satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.
38+
- JavaScript
39+
- Prettier
40+
- ESLint
41+
- Husky
42+
- Litmus UI
43+
- Material UI
3744

38-
Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you’re on your own.
45+
## Contribution Guidelines
3946

40-
You don’t have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn’t feel obligated to use this feature. However we understand that this tool wouldn’t be useful if you couldn’t customize it when you are ready for it.
41-
42-
## Learn More
43-
44-
You can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).
45-
46-
To learn React, check out the [React documentation](https://reactjs.org/).
47-
48-
### Code Splitting
49-
50-
This section has moved here: [https://facebook.github.io/create-react-app/docs/code-splitting](https://facebook.github.io/create-react-app/docs/code-splitting)
51-
52-
### Analyzing the Bundle Size
53-
54-
This section has moved here: [https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size](https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size)
55-
56-
### Making a Progressive Web App
57-
58-
This section has moved here: [https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app](https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app)
59-
60-
### Advanced Configuration
61-
62-
This section has moved here: [https://facebook.github.io/create-react-app/docs/advanced-configuration](https://facebook.github.io/create-react-app/docs/advanced-configuration)
63-
64-
### Deployment
65-
66-
This section has moved here: [https://facebook.github.io/create-react-app/docs/deployment](https://facebook.github.io/create-react-app/docs/deployment)
67-
68-
### `yarn build` fails to minify
69-
70-
This section has moved here: [https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify](https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify)
47+
Check our official [contribution guidelines](https://github.com/litmuschaos/litmus-e2e/blob/gh-pages/CONTRIBUTION.md).

0 commit comments

Comments
 (0)