Skip to content

Commit de3bc87

Browse files
committed
docs(readme): format document and fix some typos
1 parent 4bc4a87 commit de3bc87

File tree

1 file changed

+64
-33
lines changed

1 file changed

+64
-33
lines changed

README.md

+64-33
Original file line numberDiff line numberDiff line change
@@ -1,79 +1,99 @@
11
# ewea-web
22

3-
[![Build Status](https://travis-ci.com/CodeTanzania/ewea-web.svg?branch=develop)](https://travis-ci.org/CodeTanzania/ewea-web)
4-
[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
5-
[![Renovate enabled](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com/)
3+
[![Build
4+
Status](https://travis-ci.com/CodeTanzania/ewea-web.svg?branch=develop)](https://travis-ci.org/CodeTanzania/ewea-web)
5+
[![Commitizen
6+
friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
7+
[![Renovate
8+
enabled](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com/)
69

7-
<img src="docs/images/logo.svg"
8-
alt="EWEA Logo" width="100" height="auto" />
10+
<img src="docs/images/logo.svg" alt="EWEA Logo" width="100" height="auto" />
911

1012
## About EWEA
1113

12-
EWEA web is an Early Warning, Early Action tool that facilitates the disseminationn of warnings, communication and actions associated with the warnings.
14+
EWEA web is an Early Warning, Early Action tool that facilitates the
15+
dissemination of warnings, communication and actions associated with the
16+
warnings.
1317

14-
Information that is shared with the tool can be analyzed in order generate insights for local authorities and communities to better manage disasters and increase resilience to disaster risk. The data is organized in core components as shown below.
18+
Information that is shared with the tool can be analyzed in order generate
19+
insights for local authorities and communities to better manage disasters and
20+
increase resilience to disaster risk. The data is organized in core components
21+
as shown below.
1522

1623
![EWEA Homepage](docs/images/home.png 'EWEA Homepage')
1724

1825
## EWEA Components
1926

2027
#### Issued Alerts
2128

22-
Issued Alerts consists of alerts have been sent to stakeholders. These alerts are normally sent with actions to be taken.
29+
Issued Alerts consists of alerts have been sent to stakeholders. These alerts
30+
are normally sent with actions to be taken.
2331

24-
See API source code [repository](https://github.com/CodeTanzania/emis-alert).
32+
View [repository](https://github.com/CodeTanzania/emis-alert).
2533

2634
#### Actions Taken
2735

28-
Actions Taken is a set of visualizations that show activity for actions that have been dispatched with issued alerts
36+
Actions Taken is a set of visualizations that show activity for actions that
37+
have been dispatched with issued alerts
2938

30-
See API source code [repository](https://github.com/CodeTanzania/emis-stakeholder).
39+
View [repository](https://github.com/CodeTanzania/emis-stakeholder).
3140

3241
#### Emergency Functions
3342

34-
Emergency Functions is a collection of all major activities that are expected to take place during emergency management.
43+
Emergency Functions is a collection of all major activities that are expected
44+
to take place during emergency management.
3545

36-
See API source code [repository](https://github.com/CodeTanzania/emis-stakeholder).
46+
View [repository](https://github.com/CodeTanzania/emis-stakeholder).
3747

3848
#### Action Catalog
3949

4050
Action Catalog is a collection of all tasks that can take place when an alert is issued.
4151

42-
See API source code [repository](https://github.com/CodeTanzania/emis-stakeholder).
52+
View [repository](https://github.com/CodeTanzania/emis-stakeholder).
4353

4454
#### Stakeholders
4555

46-
EWEA Stakeholders contains an up to date database of all stakeholders responsible for emergency/disaster management within a specific area. They are categorized into three groups
56+
EWEA Stakeholders contains an up to date database of all stakeholders
57+
responsible for emergency/disaster management within a specific area. They are
58+
categorized into three groups
4759

4860
- Focal People - Individual personnel who has a responsibility in disaster management.
4961
- Agencies - Organizations that carry out disaster management activities.
5062
- Roles - These are configured functions that a focal person or agency is part of.
5163

52-
See API source code [repository](https://github.com/CodeTanzania/emis-stakeholder).
64+
View [repository](https://github.com/CodeTanzania/emis-stakeholder).
5365

5466
#### Alert Types
5567

5668
Alert Types are configured names of all expected events
5769

58-
See API source code [repository](https://github.com/CodeTanzania/emis-alert).
70+
View [repository](https://github.com/CodeTanzania/emis-alert).
5971

6072
#### Geographical Features
6173

62-
Geographical Features provides an up to date geographical database of all features of interest that can be used to study and control the expected and the actual extent of impact that may be caused in case of an emergency/disaster. It includes administrative boundaries of regions, districts, wards, subwards (streets), evacuation centers, facilities, warehouses and critical infrastructures.
74+
Geographical Features provides an up to date geographical database of all
75+
features of interest that can be used to study and control the expected and the
76+
actual extent of impact that may be caused in case of an emergency/disaster. It
77+
includes administrative boundaries of regions, districts, wards, sub-wards
78+
(streets), evacuation centers, facilities, warehouses and critical
79+
infrastructures.
6380

64-
See API source code [repository](https://github.com/CodeTanzania/emis-feature).
81+
View [repository](https://github.com/CodeTanzania/emis-feature).
6582

6683
#### Dashboards
6784

68-
EWEA dashboards consists of maps used for visualization and analysis of warnings and areas of interest.
85+
EWEA dashboards consists of maps used for visualization and analysis of
86+
warnings and areas of interest.
6987

70-
See API source code [repository]().
88+
View [repository](https://github.com/CodeTanzania/ewea-reports).
7189

7290
## Contribute
7391

74-
If you are interested in fixing issues and contributing directly to the code base, please read our [contributing guide](https://github.com/CodeTanzania/ewea-web/blob/develop/CONTRIBUTING.md).
92+
If you are interested in fixing issues and contributing directly to the code
93+
base, please read our [contributing guide](https://github.com/CodeTanzania/ewea-web/blob/develop/CONTRIBUTING.md).
7594

76-
Please also see [code of conduct](https://github.com/CodeTanzania/ewea-web/blob/develop/CONTRIBUTING.md) to know what we expect of all project participants.
95+
Please also read [code of conduct](https://github.com/CodeTanzania/ewea-web/blob/develop/CONTRIBUTING.md)
96+
to know what we expect of all project participants.
7797

7898
When you are done, go ahead and install the project.
7999

@@ -82,35 +102,34 @@ When you are done, go ahead and install the project.
82102
Clone the project
83103

84104
```sh
85-
git clone https://github.com/CodeTanzania/ewea-web.git
105+
git clone https://github.com/CodeTanzania/ewea-web.git
86106
```
87107

88108
Install all required dependencies
89109

90110
```sh
91-
yarn install
111+
npm install
92112
```
93113

94114
### Run it in development mode
95115

96116
```sh
97-
yarn start
117+
npm start
98118
```
99119

100120
and view it on http://localhost:3000
101121

102122
## Documentation
103123

104124
- [Project website]()
105-
- [A collection of references for ewea]()
106125
- [Http client for EWEA API](https://github.com/CodeTanzania/ewea-api-client)
107126
- [Redux state manager for EWEA](https://github.com/CodeTanzania/ewea-api-states)
108127

109128
## References
110129

111130
- [Create React App](https://create-react-app.dev/)
112131
- [Add a web app manifest](https://web.dev/add-manifest/)
113-
- [Adaptive icon support in PWAs](https://web.dev/maskable-icon/)
132+
- [Adaptive icon support in PWA](https://web.dev/maskable-icon/)
114133
- [Web App Manifest Generator](https://app-manifest.firebaseapp.com/)
115134
- [awesome-meta-and-manifest](https://github.com/gokulkrishh/awesome-meta-and-manifest)
116135

@@ -120,8 +139,20 @@ MIT License
120139

121140
Copyright (c) 2019 - present Code Tanzania & Contributors
122141

123-
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
124-
125-
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
126-
127-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
142+
Permission is hereby granted, free of charge, to any person obtaining a copy of
143+
this software and associated documentation files (the "Software"), to deal in
144+
the Software without restriction, including without limitation the rights to
145+
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
146+
of the Software, and to permit persons to whom the Software is furnished to do
147+
so, subject to the following conditions:
148+
149+
The above copyright notice and this permission notice shall be included in all
150+
copies or substantial portions of the Software.
151+
152+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
153+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
154+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
155+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
156+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
157+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
158+
SOFTWARE.

0 commit comments

Comments
 (0)