Skip to content

Commit 2650fe7

Browse files
committed
Add Contributing page
1 parent 255e5a9 commit 2650fe7

File tree

2 files changed

+39
-24
lines changed

2 files changed

+39
-24
lines changed

CONTRIBUTING.md

+34
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
2+
## Contributing
3+
4+
Contributions are most welcome, and the more eyes on the code the better.
5+
6+
Install phing on your development machine - it's used for tests, checking/fixing code style,
7+
and anything else you care to use it for!
8+
9+
### Check list
10+
* Write tests - pull requests should come with full coverage
11+
* Check the code style
12+
13+
### To get started:
14+
* Fork this library
15+
* Check out the code:
16+
- `git clone [email protected]:yourfork/bitcoin-php && cd bitcoin-php`
17+
* Start your own branch:
18+
- `git checkout -b your-feature-branch`
19+
* Check your work:
20+
- Codestyle check: `phing phpcs`
21+
- Codestyle fixer: `phing phpcbf`
22+
- Run tests: `phing phpunit`
23+
- Running `phing` will default to using `phpcbf` and `phpunit`, so running it before a commit is perfect.
24+
* Check code coverage: build/docs/code-coverage/index.html
25+
* Commit your work: `git commit ... `
26+
* Push your work:
27+
- `git push origin your-feature-branch`
28+
* And open a pull request!
29+
30+
There will always be some iteration over new features - mainly this is to ensure classes
31+
don't run afoul of scope creep, and that the library remains precise and powerful.
32+
33+
Please GPG sign your commits if possible: `git commit -S ...`
34+

README.md

+5-24
Original file line numberDiff line numberDiff line change
@@ -45,35 +45,16 @@ or
4545
"require": "bitwasp/bitcoin"
4646
}```
4747
48-
4948
## Contributing
50-
Contributions are most welcome, and the more eyes on the code the better.
51-
52-
To get started:
53-
- Fork this library
54-
- Check out the code:
55-
`git clone [email protected]:yourfork/bitcoin-php && cd bitcoin-php`
56-
- Start your own branch:
57-
`git checkout -b your-feature-branch`
58-
- Check your work, and apply code style:
59-
(phing): `phing`
60-
(other) `vendor/bin/phpunit && vendor/bin/phpcbf -n --standard=PSR1,PSR2 tests src`
61-
- Commit your work: `git commit ... ` sign it with GPG if you can: `git commit -S ...`
62-
- Push your work:
63-
`git push origin your-feature-branch`
64-
- And open a pull request!
65-
66-
There will always be some iteration over new features - mainly this is to ensure
67-
classes don't run afoul of scope creep, and that the library remains precise and powerful.
68-
69-
Please supplement all submissions with tests, and ensure it conforms with the code style.
49+
50+
All contributions are welcome. Please see (this page)[https://github.com/Bit-Wasp/bitcoin-php/blob/master/CONTRIBUTING.md] before you get started
7051
7152
##Presently supported:
7253
7354
- Bloom filters
7455
- Blocks, headers, and merkle blocks.
7556
- Regular/P2SH scripts.
76-
- An adaptable elliptic-curve library, using mdanter/phpecc by default, or libsecp256k1 if the bindings are found.
57+
- An adaptable elliptic-curve library, using (mdanter/phpecc)[https://github.com/mdanter/phpecc] by default, or libsecp256k1 if the bindings are found.
7758
- Support for building, parsing, signing/validating transactions.
7859
- Deterministic signatures (RFC6979)
7960
- BIP32 and electrum (older type I) deterministic key algorithms.
@@ -82,7 +63,7 @@ or
8263
- RPC bindings to Bitcoin Core's RPC, getting OOP responses
8364
- Bindings to Stratum (electrum) servers
8465
- Easy serialization to binary representation of most classes
85-
- SIGHASH types when creating transactions (not tested)
66+
- SIGHASH types when creating transactions
8667
- Payment Protocol (BIP70)
8768
- Blockchain classes utilizing the doctrine/cache package
8869
@@ -100,7 +81,7 @@ or
10081
- BIP0032 - Hierarchical Deterministic Wallets
10182
- BIP0035 - Mempool Message
10283
- BIP0037 - Blooom Filtering
103-
- BIP0039 - Mnemonic code for generating determinisitc keys
84+
- BIP0039 - Mnemonic code for generating deterministic keys
10485
- BIP0066 - Strict DER Signatures
10586
- BIP0067 - Deterministic P2SH multi-signature addresses
10687
- BIP0070 - Payment Protocol

0 commit comments

Comments
 (0)