Skip to content

Commit 56f02d1

Browse files
Merge pull request #94 from stefanDeveloper/documentation/rc1-developer-guide
Add developer guide section to readthedocs for better structure
2 parents feb9e6d + cbff8a6 commit 56f02d1

File tree

3 files changed

+18
-15
lines changed

3 files changed

+18
-15
lines changed

docs/developer_guide.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
Developer Guide
2+
===============
3+
4+
This section describes useful information for contributors of the project.
5+
6+
Commit Hook
7+
------------
8+
9+
Contributing to the project you might be noting failed pipeline runs.
10+
This can be due to the pre-commit hook finding errors in the formatting. Therefore, we suggest you run
11+
12+
.. code-block:: console
13+
14+
(.venv) pre-commit run --show-diff-on-failure --color=always --all-files
15+
16+
before committing your changes to GitHub.
17+
This reformates the code accordingly, preventing errors in the pipeline.

docs/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,5 +24,6 @@ Contents
2424
pipeline
2525
monitoring
2626
training
27+
developer_guide
2728
api/index
2829
references

docs/usage.rst

Lines changed: 0 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -49,21 +49,6 @@ Now, you can start each module, e.g. the `Inspector`:
4949
5050
(.venv) $ python src/inspector/main.py
5151
52-
53-
Commit Hook
54-
------------
55-
56-
Contributing to the project you might be noting failed pipeline runs.
57-
This can be due to the pre.commit hook finding errors in the formatting. Therefore, we suggest you run
58-
59-
.. code-block:: console
60-
61-
(.venv) pre-commit run --show-diff-on-failure --color=always --all-files
62-
63-
before committing your changes to GitHub.
64-
This reformates the code accordingly, preventing errors in the pipeline.
65-
66-
6752
Configuration
6853
-------------
6954

0 commit comments

Comments
 (0)