Skip to content

Commit c3056e7

Browse files
fix: Contributing docs
1 parent 870740e commit c3056e7

File tree

2 files changed

+75
-71
lines changed

2 files changed

+75
-71
lines changed

CONTRIBUTING.md

Lines changed: 5 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -1,76 +1,10 @@
11
# Contribute
22

33
Overall guidance on contributing to a PyAnsys library appears in the
4-
[Contributing] topic in the *PyAnsys developer's guide*. Ensure that you
4+
*Contributing* topic in the *[PyAnsys developer's guide]*. Ensure that you
55
are thoroughly familiar with this guide before attempting to contribute to
6-
allie-flowkit-python.
6+
allie-flowkit-python. For contributing to this project, please refer to the
7+
[Contributing] section of this project's documentation.
78

8-
The following contribution information is specific to *Allie Flowkit Python*.
9-
10-
[Contributing]: https://dev.docs.pyansys.com/how-to/contributing.html
11-
12-
## Clone the repository
13-
14-
To clone and install the latest *Allie Flowkit Python* release in development mode, run
15-
these commands:
16-
17-
```bash
18-
git clone https://github.com/ansys/allie-flowkit-python/
19-
cd allie-flowkit-python
20-
python -m pip install --upgrade pip
21-
pip install -e .
22-
```
23-
24-
## Adhere to code style
25-
26-
*Allie Flowkit Python* follows the PEP8 standard as outlined in PEP 8 in the PyAnsys Developer’s Guide and implements style checking using pre-commit.
27-
28-
To ensure your code meets minimum code styling standards, run these commands:
29-
30-
```bash
31-
pip install pre-commit
32-
pre-commit run --all-files
33-
```
34-
35-
You can also install this as a pre-commit hook by running this command:
36-
37-
```bash
38-
pre-commit install
39-
```
40-
41-
## Run the tests
42-
43-
Prior to running the tests, you must run this command to install the test dependencies:
44-
45-
```bash
46-
pip install -e .[tests]
47-
```
48-
49-
To run the tests, navigate to the root directory of the repository and run this command:
50-
51-
```bash
52-
pytest
53-
```
54-
55-
56-
## Build the documentation
57-
58-
Prior to building the documentation, you must run this command to install the documentation dependencies:
59-
60-
```bash
61-
pip install -e .[doc]
62-
```
63-
64-
To build the documentation, run the following commands:
65-
66-
```bash
67-
cd doc
68-
69-
# On linux
70-
make html
71-
72-
# On windows
73-
./make.bat html
74-
```
75-
76-
The documentation is built in the `docs/_build/html` directory.
9+
[PyAnsys Developer's Guide]: https://dev.docs.pyansys.com/index.html
10+
[Contributing]: expert-adventure-nvnoo1y.pages.github.io/dev/contributing.html

doc/source/contributing.rst

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,3 +9,73 @@ in the *PyAnsys developer's guide*. Ensure that you are thoroughly familiar
99
with this guide before attempting to contribute to the Allie Flowkit Python.
1010

1111
The following contribution information is specific to the Allie Flowkit Python.
12+
13+
14+
Clone the repository
15+
--------------------
16+
17+
To clone and install the latest *Allie Flowkit Python* release in development mode, run
18+
these commands:
19+
20+
.. code::
21+
22+
git clone https://github.com/ansys/allie-flowkit-python/
23+
cd allie-flowkit-python
24+
python -m pip install --upgrade pip
25+
pip install -e .
26+
27+
Adhere to code style
28+
--------------------
29+
30+
*Allie Flowkit Python* follows the PEP8 standard as outlined in PEP 8 in the PyAnsys Developer’s Guide and implements style checking using pre-commit.
31+
32+
To ensure your code meets minimum code styling standards, run these commands:
33+
34+
.. code::
35+
36+
pip install pre-commit
37+
pre-commit run --all-files
38+
39+
You can also install this as a pre-commit hook by running this command:
40+
41+
.. code::
42+
43+
pre-commit install
44+
45+
Run the tests
46+
-------------
47+
48+
Prior to running the tests, you must run this command to install the test dependencies:
49+
50+
.. code::
51+
52+
pip install -e .[tests]
53+
54+
To run the tests, navigate to the root directory of the repository and run this command:
55+
56+
.. code::
57+
58+
pytest
59+
60+
Build the documentation
61+
-----------------------
62+
63+
Prior to building the documentation, you must run this command to install the documentation dependencies:
64+
65+
.. code::
66+
67+
pip install -e .[doc]
68+
69+
To build the documentation, run the following commands:
70+
71+
.. code::
72+
73+
cd doc
74+
75+
# On linux
76+
make html
77+
78+
# On windows
79+
./make.bat html
80+
81+
The documentation is built in the `docs/_build/html` directory.

0 commit comments

Comments
 (0)