-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Move contributing section to its own page.
- Loading branch information
Showing
3 changed files
with
64 additions
and
60 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,61 @@ | ||
## Contributing | ||
|
||
Contributions are both encouraged and greatly appreciated. | ||
|
||
To contribute content, fork this repo and make a pull request to the master branch including your changes. | ||
|
||
- On GitHub, fork the p2pool-api repo | ||
- Clone your newly created repo. (Note: replace your-username with your GitHub username) | ||
|
||
via ssh: | ||
|
||
``` | ||
git clone [email protected]:your-username/p2pool-api | ||
``` | ||
|
||
via https: | ||
|
||
``` | ||
git clone https://github.com/your-username/p2pool-api | ||
``` | ||
|
||
- Navigate to the repo and create a new topic branch | ||
|
||
``` | ||
cd p2pool-api | ||
git checkout -b foobar | ||
``` | ||
|
||
- After making modifications, commit and push your changes to your topic branch | ||
- Open a PR against the p2pool-api main branch | ||
|
||
## Run the documentation server locally | ||
|
||
This documentation can be built and run locally. | ||
|
||
- The build process for mkdocs utilizes Python | ||
- It is recommended to install python pip dependencies inside of a Virtual Environment [(venv)](https://squidfunk.github.io/mkdocs-material/guides/creating-a-reproduction/#environment) | ||
|
||
Note: You may need to first install `python3-venv` or the equivalent for your distribution | ||
|
||
- Navigate to your `p2pool-api` repo | ||
- Create the python virtual environment | ||
|
||
```bash | ||
python3 -m venv .venv | ||
source .venv/bin/activate | ||
``` | ||
|
||
- Install mkdocs dependencies to the venv | ||
|
||
```bash | ||
pip install -r requirements.txt | ||
``` | ||
|
||
- Run the documentation server locally | ||
|
||
```bash | ||
mkdocs serve | ||
``` | ||
|
||
- View your changes at [http://localhost:8000](http://localhost:8000) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -4,73 +4,15 @@ | |
 | ||
 | ||
|
||
This module provides the `P2PoolAPI` object to allow interacting with the P2Pool API. Documentation is available [here](https://hreikin.co.uk/p2pool-api/). | ||
This module provides the `P2PoolAPI` object to allow interacting with the P2Pool API. Documentation is available [here](https://hreikin.co.uk/p2pool-api/) and can also be built locally if required. | ||
|
||
## Getting Started | ||
|
||
A quick overview of how to install and use this module can be found on the [Usage](usage.md) page, for a more detailed overview use the [Reference](reference.md) page. | ||
|
||
## Contributing | ||
|
||
Contributions are both encouraged and greatly appreciated. | ||
|
||
To contribute content, fork this repo and make a pull request to the master branch including your changes. | ||
|
||
- On GitHub, fork the p2pool-api repo | ||
- Clone your newly created repo. (Note: replace your-username with your GitHub username) | ||
|
||
via ssh: | ||
|
||
``` | ||
git clone [email protected]:your-username/p2pool-api | ||
``` | ||
|
||
via https: | ||
|
||
``` | ||
git clone https://github.com/your-username/p2pool-api | ||
``` | ||
|
||
- Navigate to the repo and create a new topic branch | ||
|
||
``` | ||
cd p2pool-api | ||
git checkout -b foobar | ||
``` | ||
|
||
- After making modifications, commit and push your changes to your topic branch | ||
- Open a PR against the p2pool-api main branch | ||
|
||
## Run the documentation server locally | ||
|
||
This documentation can be built and run locally. | ||
|
||
- The build process for mkdocs utilizes Python | ||
- It is recommended to install python pip dependencies inside of a Virtual Environment [(venv)](https://squidfunk.github.io/mkdocs-material/guides/creating-a-reproduction/#environment) | ||
|
||
Note: You may need to first install `python3-venv` or the equivalent for your distribution | ||
|
||
- Navigate to your `p2pool-api` repo | ||
- Create the python virtual environment | ||
|
||
```bash | ||
python3 -m venv .venv | ||
source .venv/bin/activate | ||
``` | ||
|
||
- Install mkdocs dependencies to the venv | ||
|
||
```bash | ||
pip install -r requirements.txt | ||
``` | ||
|
||
- Run the documentation server locally | ||
|
||
```bash | ||
mkdocs serve | ||
``` | ||
|
||
- View your changes at [http://localhost:8000](http://localhost:8000) | ||
Contributions are both encouraged and greatly appreciated, more information can be found on the [Contributing](CONTRIBUTING.md) page. | ||
|
||
## Donations | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters