Skip to content

Commit

Permalink
Move contributing section to its own page.
Browse files Browse the repository at this point in the history
  • Loading branch information
hreikin committed Nov 30, 2024
1 parent 6f869a1 commit f66759b
Show file tree
Hide file tree
Showing 3 changed files with 64 additions and 60 deletions.
61 changes: 61 additions & 0 deletions docs/CONTRIBUTING.md
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)
62 changes: 2 additions & 60 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,73 +4,15 @@
![PyPI - Downloads](https://img.shields.io/pypi/dm/p2pool-api?label=PyPI%20Downloads)
![License](https://img.shields.io/github/license/hreikin/p2pool-api?label=License&color=green)

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

Expand Down
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ nav:
- "Home": "README.md"
- "Usage": "usage.md"
- "Reference": "reference.md"
- "Contributing": "CONTRIBUTING.md"

plugins:
- search
Expand Down

0 comments on commit f66759b

Please sign in to comment.