1
0
mirror of https://github.com/bitcoinbook/bitcoinbook synced 2024-11-22 16:18:11 +00:00
bitcoinbook/CONTRIBUTING.md
Andreas M. Antonopoulos ce072c2e0e Updated CONTRIBUTING
Updated the contribution guide to reflect the third edition
2024-01-28 11:52:38 -06:00

52 lines
2.9 KiB
Markdown

# Guide to contributing
This book is developed collaboratively and openly, here on GitHub. We accept comments, contributions and corrections from all.
## Current Project STATUS
**THIRD EDITION PUBLISHED**
## License and attribution
All contributions must be properly licensed and attributed. If you are contributing your own original work, then you are offering it under a CC-BY license (Creative Commons Attribution). You are responsible for adding your own name or pseudonym in the [Github Contributors](github_contrib.asciidoc) section, as attribution for your contribution.
If you are sourcing a contribution from somewhere else, it must carry a compatible license. The book will initially be released under a CC-BY-NC-ND license which means that contributions must be licensed under open licenses such as MIT, CC0, CC-BY, etc. You need to indicate the original source and original license, by including an asciidoc markup comment above your contribution, like this:
```asciidoc
////
Source: https://example.com/originaltext
License: CC0
Added by: @aantonop
////
```
## Contributing with a Pull Request
Please submit only PRs for errors that a non-domain-expert copy editor might miss. Do not submit PRs for typos, grammar and syntax, as those are part of the copy editors job.
The best way to contribute to this book is by making a pull request:
1. Login with your GitHub account or create one now
2. [Fork](https://github.com/bitcoinbook/bitcoinbook#fork-destination-box) the `bitcoinbook` repository. Work on your fork.
3. Create a new branch on which to make your change, e.g. `git checkout -b my_code_contribution`, or make the change on the `develop` branch.
4. Please do one pull request *per asciidoc file*, to avoid large merges. Edit the asciidoc file where you want to make a change.
5. If you want attribution for your contribution, edit the file `meta/github_contrib.adoc` and add your own name to the list of contributors under the Acknowledgment section. Use your name, or a GitHub username, or a pseudonym. You are responsible for creating an attribution.
6. Commit your change. Include a commit message describing the correction.
7. Submit a pull request against the bitcoinbook repository.
## Contributing with an issue
If you find a mistake and you're not sure how to fix it, or you don't know how to do a pull request, then you can file an Issue. Filing an Issue will help us see the problem and fix it.
## Line endings
All submissions should use Unix-like line endings: LF (not CR, not CR/LF). All the postprocessing is done on Unix-like systems. Incorrect line endings, or changes to line endings cause confusion for the diff tools and make the whole file look like it has changed.
If you are unsure or your OS makes things difficult, consider using a developer's text editor such as VSCode.
## Thanks
We are very grateful for the support of the entire Bitcoin community. Thank you!