Skip to content
This repository was archived by the owner on Nov 6, 2020. It is now read-only.

Commit 6c96b60

Browse files
5chdnTbaut
authored andcommitted
docs: add parity ethereum logo to readme (#9415)
* docs: add parity ethereum logo * docs: add logo to readme * docs: align logo center * docs: remove separators from readme * docs: restructure readme * docs: check spelling and grammar in readme * docs: clarify readme * docs: improve readme significantly
1 parent ac1900a commit 6c96b60

File tree

2 files changed

+59
-57
lines changed

2 files changed

+59
-57
lines changed

README.md

Lines changed: 58 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,44 @@
1-
## Parity-Ethereum - a fast, light, and robust EVM and WASM blockchain client
1+
![Parity Ethereum](docs/logo-parity-ethereum.svg)
22

3-
### [» Download the latest release «](https://github.com/paritytech/parity-ethereum/releases/latest)
3+
## The fastest and most advanced Ethereum client.
44

5-
[![build status](https://gitlab.parity.io/parity/parity/badges/master/build.svg)](https://gitlab.parity.io/parity/parity/commits/master)
6-
[![codecov](https://codecov.io/gh/paritytech/parity-ethereum/branch/master/graph/badge.svg)](https://codecov.io/gh/paritytech/parity-ethereum)
7-
[![Snap Status](https://build.snapcraft.io/badge/paritytech/parity.svg)](https://build.snapcraft.io/user/paritytech/parity)
8-
[![GPLv3](https://img.shields.io/badge/license-GPL%20v3-green.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html)
5+
<p align="center"><strong><a href="https://github.com/paritytech/parity-ethereum/releases/latest">» Download the latest release «</a></strong></p>
96

7+
<p align="center"><a href="https://gitlab.parity.io/parity/parity/commits/master" target="_blank"><img src="https://gitlab.parity.io/parity/parity/badges/master/build.svg" /></a>
8+
<a href="https://codecov.io/gh/paritytech/parity-ethereum" target="_blank"><img src="https://codecov.io/gh/paritytech/parity-ethereum/branch/master/graph/badge.svg" /></a>
9+
<a href="https://build.snapcraft.io/user/paritytech/parity" target="_blank"><img src="https://build.snapcraft.io/badge/paritytech/parity.svg" /></a>
10+
<a href="https://www.gnu.org/licenses/gpl-3.0.en.html" target="_blank"><img src="https://img.shields.io/badge/license-GPL%20v3-green.svg" /></a></p>
1011

11-
### Join the chat!
12+
**Built for mission-critical use**: Miners, service providers, and exchanges need fast synchronisation and maximum uptime. Parity Ethereum provides the core infrastructure essential for speedy and reliable services.
1213

13-
Get in touch with us on Gitter:
14-
[![Gitter: Parity](https://img.shields.io/badge/gitter-parity-4AB495.svg)](https://gitter.im/paritytech/parity)
15-
[![Gitter: Parity.js](https://img.shields.io/badge/gitter-parity.js-4AB495.svg)](https://gitter.im/paritytech/parity.js)
16-
[![Gitter: Parity/Miners](https://img.shields.io/badge/gitter-parity/miners-4AB495.svg)](https://gitter.im/paritytech/parity/miners)
17-
[![Gitter: Parity-PoA](https://img.shields.io/badge/gitter-parity--poa-4AB495.svg)](https://gitter.im/paritytech/parity-poa)
18-
19-
Or join our community on Matrix:
20-
[![Riot: +Parity](https://img.shields.io/badge/riot-%2Bparity%3Amatrix.parity.io-orange.svg)](https://riot.im/app/#/group/+parity:matrix.parity.io)
14+
- Clean, modular codebase for easy customisation
15+
- Advanced CLI-based client
16+
- Minimal memory and storage footprint
17+
- Synchronise in hours, not days with Warp Sync
18+
- Modular for light integration into your service or product
2119

22-
Official website: https://parity.io | Be sure to check out [our wiki](https://wiki.parity.io) for more information.
20+
## Technical Overview
2321

24-
----
22+
Parity Ethereum's goal is to be the fastest, lightest, and most secure Ethereum client. We are developing Parity Ethereum using the sophisticated and cutting-edge **Rust programming language**. Parity Ethereum is licensed under the GPLv3 and can be used for all your Ethereum needs.
2523

26-
## About Parity-Ethereum
24+
By default, Parity Ethereum runs a JSON-RPC HTTP server on port `:8545` and a Web-Sockets server on port `:8546`. This is fully configurable and supports a number of APIs.
2725

28-
Parity-Ethereum's goal is to be the fastest, lightest, and most secure Ethereum client. We are developing Parity-Ethereum using the sophisticated and cutting-edge Rust programming language. Parity-Ethereum is licensed under the GPLv3, and can be used for all your Ethereum needs.
26+
If you run into problems while using Parity Ethereum, check out the [wiki for documentation](https://wiki.parity.io/), feel free to [file an issue in this repository](https://github.com/paritytech/parity-ethereum/issues/new), or hop on our [Gitter](https://gitter.im/paritytech/parity) or [Riot](https://riot.im/app/#/group/+parity:matrix.parity.io) chat room to ask a question. We are glad to help! **For security-critical issues**, please refer to the security policy outlined in [SECURITY.md](SECURITY.md).
2927

30-
By default, Parity-Ethereum will run a JSON-RPC HTTP server on `127.0.0.1:8545` and a Web-Sockets server on `127.0.0.1:8546`. This is fully configurable and supports a number of APIs.
28+
Parity Ethereum's current beta-release is 2.0. You can download it at [the releases page](https://github.com/paritytech/parity-ethereum/releases) or follow the instructions below to build from source. Please, mind the [CHANGELOG.md](CHANGELOG.md) for a list of all changes between different versions.
3129

32-
If you run into problems while using Parity-Ethereum, feel free to file an issue in this repository or hop on our [Gitter](https://gitter.im/paritytech/parity) or [Riot](https://riot.im/app/#/group/+parity:matrix.parity.io) chat room to ask a question. We are glad to help! **For security-critical issues**, please refer to the security policy outlined in [SECURITY.md](SECURITY.md).
30+
## Build Dependencies
3331

34-
Parity-Ethereum's current beta-release is 2.0. You can download it at [the releases page](https://github.com/paritytech/parity-ethereum/releases) or follow the instructions below to build from source. Please, mind the [CHANGELOG.md](CHANGELOG.md) for a list of all changes between different versions.
32+
Parity Ethereum requires **Rust version 1.28.x** to build.
3533

36-
----
37-
38-
## Build dependencies
39-
40-
**Parity-Ethereum requires Rust version 1.27.0 to build**
41-
42-
We recommend installing Rust through [rustup](https://www.rustup.rs/). If you don't already have rustup, you can install it like this:
34+
We recommend installing Rust through [rustup](https://www.rustup.rs/). If you don't already have `rustup`, you can install it like this:
4335

4436
- Linux:
4537
```bash
4638
$ curl https://sh.rustup.rs -sSf | sh
4739
```
4840

49-
Parity-Ethereum also requires `gcc`, `g++`, `libudev-dev`, `pkg-config`, `file`, `make`, and `cmake` packages to be installed.
41+
Parity Ethereum also requires `gcc`, `g++`, `libudev-dev`, `pkg-config`, `file`, `make`, and `cmake` packages to be installed.
5042

5143
- OSX:
5244
```bash
@@ -56,54 +48,50 @@ We recommend installing Rust through [rustup](https://www.rustup.rs/). If you do
5648
`clang` is required. It comes with Xcode command line tools or can be installed with homebrew.
5749

5850
- Windows
59-
Make sure you have Visual Studio 2015 with C++ support installed. Next, download and run the rustup installer from
60-
https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe, start "VS2015 x64 Native Tools Command Prompt", and use the following command to install and set up the msvc toolchain:
51+
Make sure you have Visual Studio 2015 with C++ support installed. Next, download and run the `rustup` installer from
52+
https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe, start "VS2015 x64 Native Tools Command Prompt", and use the following command to install and set up the `msvc` toolchain:
6153
```bash
6254
$ rustup default stable-x86_64-pc-windows-msvc
6355
```
6456

65-
Once you have rustup installed, then you need to install:
57+
Once you have `rustup` installed, then you need to install:
6658
* [Perl](https://www.perl.org)
6759
* [Yasm](https://yasm.tortall.net)
6860

69-
Make sure that these binaries are in your `PATH`. After that you should be able to build Parity-Ethereum from source.
61+
Make sure that these binaries are in your `PATH`. After that, you should be able to build Parity Ethereum from source.
7062

71-
----
72-
73-
## Install from the snap store
63+
## Install from the Snapcraft Store
7464

7565
In any of the [supported Linux distros](https://snapcraft.io/docs/core/install):
7666

7767
```bash
7868
sudo snap install parity
7969
```
8070

81-
Or, if you want to contribute testing the upcoming release:
71+
Alternatively, if you want to contribute testing the upcoming release:
8272

8373
```bash
8474
sudo snap install parity --beta
8575
```
8676

87-
And to test the latest code landed into the master branch:
77+
Moreover, to test the latest code from the master branch:
8878

8979
```bash
9080
sudo snap install parity --edge
9181
```
9282

93-
----
94-
95-
## Build from source
83+
## Build from Source Code
9684

9785
```bash
98-
# download Parity-Ethereum code
86+
# download Parity Ethereum code
9987
$ git clone https://github.com/paritytech/parity-ethereum
10088
$ cd parity-ethereum
10189

10290
# build in release mode
10391
$ cargo build --release --features final
10492
```
10593

106-
This will produce an executable in the `./target/release` subdirectory.
94+
This produces an executable in the `./target/release` subdirectory.
10795

10896
Note: if cargo fails to parse manifest try:
10997

@@ -117,7 +105,7 @@ Note, when compiling a crate and you receive errors, it's in most cases your out
117105
$ cargo clean
118106
```
119107

120-
This will always compile the latest nightly builds. If you want to build stable or beta, do a
108+
This always compiles the latest nightly builds. If you want to build stable or beta, do a
121109

122110
```bash
123111
$ git checkout stable
@@ -129,11 +117,7 @@ or
129117
$ git checkout beta
130118
```
131119

132-
first.
133-
134-
----
135-
136-
## Simple one-line installer for Mac and Ubuntu
120+
## Simple One-Line Installer for Mac and Linux
137121

138122
```bash
139123
bash <(curl https://get.parity.io -L)
@@ -145,22 +129,39 @@ The one-line installer always defaults to the latest beta release. To install a
145129
bash <(curl https://get.parity.io -L) -r stable
146130
```
147131

148-
## Start Parity-Ethereum
132+
## Start Parity Ethereum
149133

150134
### Manually
151135

152-
To start Parity-Ethereum manually, just run
136+
To start Parity Ethereum manually, just run
153137

154138
```bash
155139
$ ./target/release/parity
156140
```
157141

158-
and Parity-Ethereum will begin syncing the Ethereum blockchain.
142+
so Parity Ethereum begins syncing the Ethereum blockchain.
159143

160-
### Using systemd service file
144+
### Using `systemd` service file
161145

162-
To start Parity-Ethereum as a regular user using systemd init:
146+
To start Parity Ethereum as a regular user using `systemd` init:
163147

164148
1. Copy `./scripts/parity.service` to your
165-
systemd user directory (usually `~/.config/systemd/user`).
166-
2. To configure Parity-Ethereum, write a `/etc/parity/config.toml` config file, see [Configuring Parity-Ethereum](https://paritytech.github.io/wiki/Configuring-Parity) for details.
149+
`systemd` user directory (usually `~/.config/systemd/user`).
150+
2. To configure Parity Ethereum, write a `/etc/parity/config.toml` config file, see [Configuring Parity Ethereum](https://paritytech.github.io/wiki/Configuring-Parity) for details.
151+
152+
## Join the chat!
153+
154+
Questions? Get in touch with us on Gitter:
155+
[![Gitter: Parity](https://img.shields.io/badge/gitter-parity-4AB495.svg)](https://gitter.im/paritytech/parity)
156+
[![Gitter: Parity.js](https://img.shields.io/badge/gitter-parity.js-4AB495.svg)](https://gitter.im/paritytech/parity.js)
157+
[![Gitter: Parity/Miners](https://img.shields.io/badge/gitter-parity/miners-4AB495.svg)](https://gitter.im/paritytech/parity/miners)
158+
[![Gitter: Parity-PoA](https://img.shields.io/badge/gitter-parity--poa-4AB495.svg)](https://gitter.im/paritytech/parity-poa)
159+
160+
Alternatively, join our community on Matrix:
161+
[![Riot: +Parity](https://img.shields.io/badge/riot-%2Bparity%3Amatrix.parity.io-orange.svg)](https://riot.im/app/#/group/+parity:matrix.parity.io)
162+
163+
## Documentation
164+
165+
Official website: https://parity.io
166+
167+
Be sure to [check out our wiki](https://wiki.parity.io) for more information.

docs/logo-parity-ethereum.svg

Lines changed: 1 addition & 0 deletions
Loading

0 commit comments

Comments
 (0)