Skip to content

Commit

Permalink
Fix doc typos
Browse files Browse the repository at this point in the history
  • Loading branch information
ghiggi committed Apr 7, 2024
1 parent cab0df7 commit 4e4df3f
Show file tree
Hide file tree
Showing 4 changed files with 18 additions and 14 deletions.
4 changes: 2 additions & 2 deletions .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@ repos:
- id: end-of-file-fixer

- repo: https://github.com/astral-sh/ruff-pre-commit
rev: v0.1.8
rev: v0.3.4
hooks:
- id: ruff
args: [--fix]

- repo: https://github.com/psf/black
rev: 23.12.0
rev: 24.3.0
hooks:
- id: black
language_version: python3
Expand Down
2 changes: 2 additions & 0 deletions CONTRIBUTING.rst
Original file line number Diff line number Diff line change
Expand Up @@ -237,6 +237,8 @@ Refer to the table below for a comprehensive summary of all CI tools employed to
+----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
| `CodeFactor <https://www.codefactor.io/>`__ | Automated code review and analysis tools |
+----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
| `Codacy <https://www.codacy.com/>`__ | Automated code review and analysis tools |
+----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+


5. Code testing with pytest
Expand Down
6 changes: 3 additions & 3 deletions docs/source/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -128,15 +128,15 @@ You can create a conda environment (i.e. with python 3.11) with:
conda create --name disdrodb-dev-py311 python=3.11 --no-default-packages
conda activate disdrodb-dev-py311
Install the disdrodb package dependencies
Install the package dependencies
............................................

.. code-block:: bash
conda install --only-deps disdrodb
Install the disdrodb package in editable mode
Install the package in editable mode
................................................

Install the disdrodb package in editable mode by executing the following command in the disdrodb repository's root:
Expand All @@ -146,7 +146,7 @@ Install the disdrodb package in editable mode by executing the following command
pip install -e ".[dev]"
Install pre-commit code quality checks
Install code quality checks
..............................................

Install the pre-commit hook by executing the following command in the disdrodb repository's root:
Expand Down
20 changes: 11 additions & 9 deletions docs/source/maintainers_guidelines.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@ Maintainers Guidelines
The section is dedicated to the DISDRODB core developers (maintainers).


List of the core contributors
Core contributors
=================================

* Current Release Manager : Ghiggi Gionata
* Testing Team : Ghiggi Gionata


Versions guidelines
Versions Guidelines
========================

DISDRODB uses `Semantic <https://semver.org/>`_ Versioning. Each release is associated with a git tag of the form X.Y.Z.
Expand Down Expand Up @@ -68,7 +68,7 @@ styled with `Book Theme <https://sphinx-book-theme.readthedocs.io/en/stable/inde
All documentation source files are neatly organized in the ``docs/`` directory within the project's repository.


Documentation generation
Documentation Generation
---------------------------

To build the documentation locally, follow the next three steps.
Expand Down Expand Up @@ -111,7 +111,7 @@ By following these steps, you should have a local version of the DISDRODB docume
in the ``docs/build/html/`` directory, ready for review or deployment!


Documentation deployment
Documentation Deployment
--------------------------

A webhook is defined in the GitHub repository to trigger automatically the publication process to `ReadTheDocs <https://about.readthedocs.com/?ref=readthedocs.com>`__
Expand All @@ -124,7 +124,7 @@ This webhook is linked to the DISDRODB core developer.
Ghiggi Gionata owns the `ReadTheDoc <https://readthedocs.org/>`__ account.


Package release
Package Release
==================

A `GitHub Action <https://github.com/ltelab/disdrodb/actions>`_ is configured to automate the packaging and uploading process
Expand All @@ -144,7 +144,7 @@ Once the conda-forge recipe is updated, a new conda-forge package is released.
The PyPI project and the conda-forge recipes are collaboratively maintained by core contributors of the project.


Release process
Release Process
----------------

Before releasing a new version, the ``CHANGELOG.md`` file should be updated. Run
Expand Down Expand Up @@ -174,7 +174,7 @@ Create a new tag to trigger the release process.
On GitHub, edit the release description to add the list of changes from the ``CHANGELOG.md`` file.


Reviewing process
Reviewing Process
====================


Expand All @@ -190,7 +190,7 @@ The review process is the following:



Continuous integration
Continuous Integration
=======================

Continuous Integration (CI) is a crucial practice in modern software development, ensuring that code changes are regularly integrated into the main codebase.
Expand Down Expand Up @@ -218,9 +218,11 @@ The table below summarizes the software tools utilized in our CI pipeline, descr
+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------+----------------------------------------------------------------------------------------------+
| `Coveralls <https://coveralls.io/>`__ | Uses Coverage to track and analyze code coverage over time. | `disdrodb <https://coveralls.io/github/ltelab/disdrodb>`__ |
+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------+----------------------------------------------------------------------------------------------+
| `CodeBeat <https://codebeat.co/>`__ | Automated code review and analysis tools | `disdrodb <https://codebeat.co/projects/github-com-ltelab-disdrodb-main/security_issues>`__ |
| `CodeBeat <https://codebeat.co/>`__ | Automated code review and analysis tools | `disdrodb <https://codebeat.co/projects/github-com-ltelab-disdrodb-main>`__ |
+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------+----------------------------------------------------------------------------------------------+
| `CodeScene <https://codescene.com/>`__ | Automated code review and analysis tools | `disdrodb <https://codescene.io/projects/36773>`__ |
+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------+----------------------------------------------------------------------------------------------+
| `CodeFactor <https://www.codefactor.io/>`__ | Automated code review and analysis tools | `disdrodb <https://www.codefactor.io/repository/github/ltelab/disdrodb>`__ |
+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------+----------------------------------------------------------------------------------------------+
| `Codacy <https://www.codacy.com/>`__ | Automated code review and analysis tools | `disdrodb <https://app.codacy.com/gh/ltelab/disdrodb/dashboard>`__ |
+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------+----------------------------------------------------------------------------------------------+

0 comments on commit 4e4df3f

Please sign in to comment.