Skip to content

Commit

Permalink
updating development documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
samarendra-pani committed Jun 20, 2024
1 parent c300931 commit 6b18ee8
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 4 deletions.
2 changes: 1 addition & 1 deletion .readthedocs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
version: 2

build:
os: "ubuntu-22.04"
os: "ubuntu-latest"
tools:
python: "3.10"

Expand Down
11 changes: 8 additions & 3 deletions docs/develop.rst
Original file line number Diff line number Diff line change
Expand Up @@ -58,9 +58,9 @@ To check for proper documentation build, proper syntax and styling, and pytest o

Before creating a pull request

#. write test cases for the new code.
#. run :code:`tox` after fixing formatting and syntax with :code:`black` and :code:`flake8`.
#. create the pull request, if the tox check passes with your local python version.
#. write test cases for the new code
#. run :code:`tox` after fixing formatting and syntax with :code:`ruff`
#. create the pull request, if the tox check passes with your local python version


Using Pre-Commit
Expand All @@ -84,6 +84,9 @@ all the file using::

pre-commit run --all-files

When the staged files fail the conditions defined in the pre-commit conditions, :code:`ruff` formatting
will attempt to fix it. After adding the files updated by :code:`ruff`, attempt to commit again. If it fails,
then the errors have to be manually fixed.

Writing Documentation
---------------------
Expand Down Expand Up @@ -111,6 +114,8 @@ Accordingly this documentation for developing will have to be changed.
Making a Release
----------------

[No releases made yet. This text is a template.]

#. Update ``CHANGES.rst``: Set the correct version number and ensure that
all nontrivial, user-visible changes are listed.

Expand Down
10 changes: 10 additions & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,10 +30,20 @@ We recommend installing inside a conda environment to allow easy removal::
conda activate gaftools-env
pip install git+https://github.com/marschall-lab/gaftools

If you already have a clone locally, then run::

git clone https://github.com/marschall-lab/gaftools
conda create -n gaftools-env python=3.10
conda activate gaftools-env
cd gaftools
pip install .

To remove gaftools, the conda environment needs to be removed using::

conda env remove -n gaftools-env

gaftools can be used with python>=3.8


Requirements
------------
Expand Down

0 comments on commit 6b18ee8

Please sign in to comment.