Skip to content

Commit f16e23c

Browse files
committed
docs: update README
1 parent 5f5ee05 commit f16e23c

6 files changed

Lines changed: 88 additions & 74 deletions

File tree

CONTRIBUTING.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
2+
# Contribution
3+
Thank you for considering contributing to this project! Here are some guidelines to help you get started.
4+
5+
## How can I contribute to this project?
6+
### Reporting Bugs
7+
If you find a bug, please report it by opening an issue in the issue tracker. Provide as much detail as possible to help us understand and reproduce the issue:
8+
- A clear and descriptive title.
9+
- A detailed description of the problem.
10+
- Steps to reproduce the issue.
11+
- Any error messages or screenshots.
12+
13+
### Suggesting Enhancements
14+
We welcome suggestions for improvements! To suggest an enhancement:
15+
- Check the issue tracker to see if someone else has already suggested it.
16+
- If not, open a new issue and describe your idea clearly.
17+
- Explain why you believe the enhancement would be beneficial.
18+
19+
### Pull Requests
20+
Pull requests are welcome! If you plan to make significant changes, please open an issue first to discuss your idea. This helps us ensure that your contribution fits with the project's direction. Follow these steps for a smooth pull request process:
21+
22+
- Fork the repository.
23+
- Clone your fork to your local machine.
24+
- Create a new branch: `git checkout -b my-feature-branch`.
25+
- Make your changes.
26+
- Commit your changes: `git commit -m 'Add some feature'.
27+
- Push to the branch: `git push origin my-feature-branch`.
28+
- Open a pull request in the original repository.
29+
30+
## Development
31+
Here are the basic commands you can use to develop this package.
32+
33+
### Install Pipenv
34+
If you don't have `pipenv` installed, you can install it using `pip`:
35+
36+
```sh
37+
pip install pipenv
38+
```
39+
40+
### Linting
41+
We use `ruff` for linting the code. To run the linter, use the following command:
42+
```sh
43+
pipenv run lint
44+
```
45+
46+
### Auto format
47+
We use `ruff` for formatting the code. To run the formatter, use the following command:
48+
```sh
49+
pipenv run format
50+
```
51+
52+
### Unit test
53+
We use `unittest` for testing the code. To run the unit tests, use the following command:
54+
```sh
55+
pipenv run unittest
56+
```

README.md

Lines changed: 10 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -17,29 +17,15 @@ This a Python package for building the regression adjusted distribution function
1717
pip install -e .
1818
```
1919

20+
## Basic Usage
21+
Examples of how to use this package are available in [this Get-started Guide](https://cyberagentailab.github.io/python-dte-adjustment/get_started.html).
22+
2023
## Development
24+
We welcome contributions to the project! Please review our [Contribution Guide](CONTRIBUTING.md) for details on how to get started.
25+
26+
## License
27+
28+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
2129

22-
### Install Pipenv
23-
If you don't have `pipenv` installed, you can install it using `pip`:
24-
25-
```sh
26-
pip install pipenv
27-
```
28-
29-
### Linting
30-
We use `ruff` for linting the code. To run the linter, use the following command:
31-
```sh
32-
pipenv run lint
33-
```
34-
35-
### Auto format
36-
We use `ruff` for formatting the code. To run the formatter, use the following command:
37-
```sh
38-
pipenv run format
39-
```
40-
41-
### Unit test
42-
We use `unittest` for testing the code. To run the unit tests, use the following command:
43-
```sh
44-
pipenv run unittest
45-
```
30+
## Maintainers
31+
- [Tomu Hirata](https://github.com/TomeHirata)

docs/source/contributing.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
Contribution Guide
2+
==================
3+
4+
Regarding how to contribute to this package, please refer to https://github.com/CyberAgentAILab/python-dte-adjustment/CONTRIBUTING.md for more details.

docs/source/development.rst

Lines changed: 0 additions & 46 deletions
This file was deleted.

docs/source/index.rst

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,17 +9,21 @@ dte_adj
99
This a Python package for building the regression adjusted distribution function estimator proposed in "Estimating Distributional Treatment Effects in Randomized Experiments: Machine Learning for Variance Reduction".
1010

1111
.. toctree::
12-
:maxdepth: 2
12+
:maxdepth: 1
1313
:caption: Contents:
1414

1515
installation
1616
get_started
17-
development
1817
modules
18+
contributing
1919

2020
Indices and tables
21-
==================
21+
~~~~~~~~~~~~~~~~~~
2222

2323
* :ref:`genindex`
2424
* :ref:`modindex`
25-
* :ref:`search`
25+
* :ref:`search`
26+
27+
License
28+
~~~~~~~
29+
MIT License

docs/source/installation.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,16 +3,26 @@ Installation Guide
33

44
This package can be installed either through PyPI or source code.
55

6+
Requirement
7+
~~~~~~~~~~~
8+
9+
You need to use Python version 3.6 or higher to use this package.
10+
11+
612
Install from PyPI
713
~~~~~~~~~~~~~~~~~
814

15+
For installing the package from PyPI, please use the following command.
16+
917
.. code-block:: bash
1018
1119
pip install dte_adj
1220
1321
Install from source code
1422
~~~~~~~~~~~~~~~~~~~~~~~~
1523

24+
For installing the package from the source code, please use the following commands.
25+
1626
.. code-block:: bash
1727
1828
git clone https://github.com/CyberAgentAILab/python-dte-adjustment

0 commit comments

Comments
 (0)