Skip to content

Commit 08beeac

Browse files
snitin315abhinavk96
andcommitted
refactor README.md (#3763)
Co-authored-by: Abhinav Khare <[email protected]>
1 parent 4f99c25 commit 08beeac

File tree

1 file changed

+38
-35
lines changed

1 file changed

+38
-35
lines changed

README.md

Lines changed: 38 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ The front end for the **Open Event Server**
1717
[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)
1818

1919
**API Documentation:**
20-
- Every installation of the **Open Event Server** project includes API docs, (e.g. here on the test install [https://open-event-api.herokuapp.com](https://open-event-api.herokuapp.com)).
21-
- A hosted version of the API docs is available in the `gh-pages` branch of the **Open Event Server** repository at [http://dev.eventyay.com/api/v1](http://dev.eventyay.com/api/v1)
20+
- Every installation of the **Open Event Server** project includes API docs, (e.g. here on the test install [https://open-event-api.herokuapp.com](https://open-event-api.herokuapp.com)).
21+
- A hosted version of the API docs is available in the `gh-pages` branch of the **Open Event Server** repository at [http://dev.eventyay.com/api/v1](http://dev.eventyay.com/api/v1)
2222

2323
## Communication
2424

@@ -28,14 +28,14 @@ Please join our [Mailing list](https://groups.google.com/forum/#!forum/open-even
2828

2929
The Open Event Frontend can be easily deployed on a variety of platforms. Detailed platform specific instructions have been provided below.
3030

31-
1. [Local Installation](/docs/installation/local.md)
32-
1. [Publish to GitHub Pages](/docs/installation/Publish-to-GitHub-Pages.md)
33-
1. [Running in Docker](/docs/installation/docker.md)
31+
1. [Local Installation](/docs/installation/local.md)
32+
2. [Publish to GitHub Pages](/docs/installation/Publish-to-GitHub-Pages.md)
33+
3. [Running in Docker](/docs/installation/docker.md)
3434

3535
## Running / Development
3636

37-
* `ember serve`
38-
* Visit your app at [http://localhost:4200](http://localhost:4200).
37+
- `ember serve`
38+
- Visit your app at [http://localhost:4200](http://localhost:4200).
3939

4040
### Code Generators
4141

@@ -45,14 +45,13 @@ Make use of the many generators for code, try `ember help generate` for more det
4545

4646
This project has acceptance, integration and unit tests located inside the `tests/` folder.
4747

48-
* `ember test` - CLI output
49-
* `ember test --server` - Live browser preview and console access
48+
- `ember test` - CLI output
49+
- `ember test --server` - Live browser preview and console access
5050

5151
### Building
5252

53-
* `ember build` (development)
54-
* `ember build --environment production` (production)
55-
53+
- `ember build` (development)
54+
- `ember build --environment production` (production)
5655

5756
## Deployments, Docker images and Releases
5857

@@ -62,51 +61,55 @@ This project has acceptance, integration and unit tests located inside the `test
6261
The master branch of open-event-frontend gets deployed in a production environment at [https://eventyay.com](https://eventyay.com)
6362
It consumes the API exposed by master branch deployment of open event server, hosted at [https://api.eventyay.com](https://api.eventyay.com)
6463

65-
**Development branch**
64+
#### Development branch
6665

6766
The **development** branch of open-event-frontend gets deployed at [https://open-event-fe.netlify.com](https://open-event-fe.netlify.com)
6867
It consumes the API exposed by development branch of open event server, hosted at [https://open-event-api-dev.herokuapp.com](https://open-event-api-dev.herokuapp.com)
6968

70-
7169
### Release Cycle
7270

7371
Stable versions will released periodically, starting from version 1.0.0 when open-event-frontend went into production. Version names will follow [semantic versioning](https://semver.org/)
7472

7573
### Docker Hub Images
7674
Docker images hosted on [open-event-frontend repository](https://cloud.docker.com/u/eventyay/repository/docker/eventyay/open-event-frontend) under eventyay organisation on docker hub are updated for each push on master and developement branch. Separate tags for each version release are also maintained. They are as follows:
7775

78-
|Branch/Release | Image|
79-
|---|---|
80-
|Master| eventyay/open-event-frontend:latest|
81-
|Development | eventyay/open-event-frontend:development |
82-
|Version(vx.y.z) | eventyay/open-event-frontend:vx.y.z|
76+
| Branch/Release | Image |
77+
| --------------- | ---------------------------------------- |
78+
| Master | eventyay/open-event-frontend:latest |
79+
| Development | eventyay/open-event-frontend:development |
80+
| Version(vx.y.z) | eventyay/open-event-frontend:vx.y.z |
8381

8482
## Further Reading / Useful Links
85-
* [ember.js](https://emberjs.com/)
86-
* [ember-cli](https://ember-cli.com/)
87-
* [Semantic UI](https://semantic-ui.com/)
88-
* [Semantic-UI-Ember](https://semantic-org.github.io/Semantic-UI-Ember/)
89-
* Development Browser Extensions
90-
* [ember inspector for chrome](https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi)
91-
* [ember inspector for firefox](https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/)
83+
84+
- [ember.js](https://emberjs.com/)
85+
86+
- [ember-cli](https://ember-cli.com/)
87+
88+
- [Semantic UI](https://semantic-ui.com/)
89+
90+
- [Semantic-UI-Ember](https://semantic-org.github.io/Semantic-UI-Ember/)
91+
92+
- Development Browser Extensions
93+
- [ember inspector for chrome](https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi)
94+
- [ember inspector for firefox](https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/)
9295

9396
## Contributions Best Practices
9497

95-
**Commits**
98+
### Commits
9699

97-
* Write clear meaningful git commit messages (Do read https://chris.beams.io/posts/git-commit/)
98-
* Make sure your PR's description contains GitHub's special keyword references that automatically close the related issue when the PR is merged. (More info at https://github.com/blog/1506-closing-issues-via-pull-requests )
99-
* When you make very minor changes to a PR of yours (like for example fixing a failing Travis build or some small style corrections or minor changes requested by reviewers) make sure you squash your commits afterward so that you don't have an absurd number of commits for a very small fix. (Learn how to squash at https://davidwalsh.name/squash-commits-git )
100-
* When you're submitting a PR for a UI-related issue, it would be really awesome if you add a screenshot of your change or a link to a deployment where it can be tested out along with your PR. It makes it very easy for the reviewers and you'll also get reviews quicker.
100+
- Write clear meaningful git commit messages (Do read [https://chris.beams.io/posts/git-commit/](https://chris.beams.io/posts/git-commit/))
101+
- Make sure your PR's description contains GitHub's special keyword references that automatically close the related issue when the PR is merged. (More info at [https://github.com/blog/1506-closing-issues-via-pull-requests](https://github.com/blog/1506-closing-issues-via-pull-requests) )
102+
- When you make very minor changes to a PR of yours (like for example fixing a failing Travis build or some small style corrections or minor changes requested by reviewers) make sure you squash your commits afterward so that you don't have an absurd number of commits for a very small fix. (Learn how to squash at [https://davidwalsh.name/squash-commits-git](https://davidwalsh.name/squash-commits-git) )
103+
- When you're submitting a PR for a UI-related issue, it would be really awesome if you add a screenshot of your change or a link to a deployment where it can be tested out along with your PR. It makes it very easy for the reviewers and you'll also get reviews quicker.
101104

102-
**Feature Requests and Bug Reports**
105+
### Feature Requests and Bug Reports
103106

104107
When you file a feature request or when you are submitting a bug report to the [issue tracker](https://github.com/fossasia/open-event-frontend/issues), make sure you add steps to reproduce it. Especially if that bug is some weird/rare one.
105108

106-
**Join the development**
109+
### Join the development
107110

108-
* Before you join development, please set up the project on your local machine, run it and go through the application completely. Press on any button you can find and see where it leads to. Explore. (Don't worry ... Nothing will happen to the app or to you due to the exploring :wink: Only thing that will happen is, you'll be more familiar with what is where and might even get some cool ideas on how to improve various aspects of the app.)
109-
* If you would like to work on an issue, drop in a comment at the issue. If it is already assigned to someone, but there is no sign of any work being done, please feel free to drop in a comment so that the issue can be assigned to you if the previous assignee has dropped it entirely.
111+
- Before you join development, please set up the project on your local machine, run it and go through the application completely. Press on any button you can find and see where it leads to. Explore. (Don't worry ... Nothing will happen to the app or to you due to the exploring :wink: Only thing that will happen is, you'll be more familiar with what is where and might even get some cool ideas on how to improve various aspects of the app.)
112+
- If you would like to work on an issue, drop in a comment at the issue. If it is already assigned to someone, but there is no sign of any work being done, please feel free to drop in a comment so that the issue can be assigned to you if the previous assignee has dropped it entirely.
110113

111114
## License
112115

0 commit comments

Comments
 (0)