You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/dev_guide/contribute.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,8 +9,8 @@ Thank you for considering making a contribution to CDIPpy! We welcome all types
9
9
## Setting up your git workflow
10
10
This project uses a fork-and-pull-request workflow. You will need to make your [fork](https://github.com/cdipsw/CDIPpy/fork) of the repository to work in, and submit changes to CDIPpy via pull request. To set up your workflow, follow these instructions:
11
11
12
-
1. Fork the respository at [https://github.com/cdipsw/CDIPpy/fork](https://github.com/cdipsw/CDIPpy/fork)
13
-
2. Clone the repository from your fork `git clone https://github.com/{your_github_username}/CDIPpy.git` - this will add your own fork as your `origin` remote repo. *Note: If you already have the main fork cloned, skip to the next step and follow instuctions to add your fork as another remote.*
12
+
1. Fork the repository at [https://github.com/cdipsw/CDIPpy/fork](https://github.com/cdipsw/CDIPpy/fork)
13
+
2. Clone the repository from your fork `git clone https://github.com/{your_github_username}/CDIPpy.git` - this will add your own fork as your `origin` remote repo. *Note: If you already have the main fork cloned, skip to the next step and follow instructions to add your fork as another remote.*
14
14
3. Add the main fork as another remote (or your fork, if you cloned from the main fork). This will allow you to pull latest code from the main fork, but push your own development to your own fork:
@@ -26,21 +26,21 @@ git checkout main # make sure this is cdip/main not your fork
26
26
git pull
27
27
git checkout -b example-branch
28
28
```
29
-
This will create a new branch called `example-branch` based on the lastest commit to `main`. Now you can start making your changes.
29
+
This will create a new branch called `example-branch` based on the latest commit to `main`. Now you can start making your changes.
30
30
31
31
Any changes you plan to contribute should be sure to follow the project's style guide, testing structure, and be up-to-date with documentation.
32
32
33
33
### linting
34
-
First you'll need to make sure your code style matches the rest of `cdippy` by using the `flake8` linter to check for adherance to the [PEP8](https://peps.python.org/pep-0008/) style guide:
34
+
First you'll need to make sure your code style matches the rest of `cdippy` by using the `flake8` linter to check for adherence to the [PEP8](https://peps.python.org/pep-0008/) style guide:
35
35
```bash
36
36
flake8 .
37
37
```
38
-
If this commnad is successful, your style is up to date! Otherwise, the output will indicate where in the project the style is not compliant. You can manually fix these style deviations, or use a tool like [`black`](https://black.readthedocs.io/en/stable/) to autolint:
38
+
If this command is successful, your style is up to date! Otherwise, the output will indicate where in the project the style is not compliant. You can manually fix these style deviations, or use a tool like [`black`](https://black.readthedocs.io/en/stable/) to autolint:
39
39
```bash
40
40
black .
41
41
```
42
42
43
-
This project also provides a [`pre-commit`](https://pre-commit.com/) hook to manage style for you autmatically on every `git commit`. From the porject root:
43
+
This project also provides a [`pre-commit`](https://pre-commit.com/) hook to manage style for you automatically on every `git commit`. From the project root:
Copy file name to clipboardExpand all lines: docs/dev_guide/index.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,13 +15,13 @@ You'll specifically want to look at configuring credentials with [https](https:/
15
15
## Install with dev tools
16
16
It is recommended to us [`uv`](https://docs.astral.sh/uv/) to manage you development environment for this project, but other package managers will likely work as well. This documentation provides instructions for using `uv`.
17
17
18
-
Navigate to the project root dirctory ('CDIPpy/') and run the following:
18
+
Navigate to the project root directory ('CDIPpy/') and run the following:
19
19
```bash
20
-
>>> pip install uv # install uv pacakge manager
21
-
>>> uv sync # create a virtual envionment at CDIPpy/.venv/, install the source code, its runtime dependencies and it's dev dependencies defined in pyproject.toml.
20
+
>>> pip install uv # install uv package manager
21
+
>>> uv sync # create a virtual environment at CDIPpy/.venv/, install the source code, its runtime dependencies and it's dev dependencies defined in pyproject.toml.
22
22
>>> source .venv/bin/activate # activate the environment
23
23
```
24
-
To exclude the development dpendancies, you can run `uv sync --no-dev`.
24
+
To exclude the development dependencies, you can run `uv sync --no-dev`.
25
25
26
26
### testing
27
27
You can check that your dev installation was successful by running unit tests from the root directory: `python -m unittest discover`.
@@ -30,6 +30,6 @@ This runs every test in the library; you should see all successful tests.
30
30
Learn more about running specific tests or subsets from the [`unittest` docs](https://docs.python.org/3/library/unittest.html).
31
31
32
32
### linting
33
-
This library uses `flake8` to check for adherance to the [PEP8](https://peps.python.org/pep-0008/) style guide. To check whether your code is compliant with the project style, run `flake8 .` from the project root. You can fix problems manually, or use a tool like [`black`](https://black.readthedocs.io/en/stable/) to autolint: `black .`.
33
+
This library uses `flake8` to check for adherence to the [PEP8](https://peps.python.org/pep-0008/) style guide. To check whether your code is compliant with the project style, run `flake8 .` from the project root. You can fix problems manually, or use a tool like [`black`](https://black.readthedocs.io/en/stable/) to autolint: `black .`.
34
34
35
-
This project also provides a [`pre-commit`](https://pre-commit.com/) hook to manage style for you autmatically on every `git commit`. To install it, run `pre-commit install` from the project root - this will use `black` and `flake` to autolint and check any changes you make for style before committing them to the repository.
35
+
This project also provides a [`pre-commit`](https://pre-commit.com/) hook to manage style for you automatically on every `git commit`. To install it, run `pre-commit install` from the project root - this will use `black` and `flake` to autolint and check any changes you make for style before committing them to the repository.
Copy file name to clipboardExpand all lines: docs/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ CDIPpy is python library for navigating and accessing products provided by the [
4
4
A goal of publishing this library as an open source, contributable package is to foster closer collaboration between CDIP and the community of users.
5
5
6
6
## Navigating these docs
7
-
The CDIP user community spans a brooad expertise and vastly different backgrounds in python development and usage - use the following guidelines to determine where to start in the documentation:
7
+
The CDIP user community spans a broad expertise and vastly different backgrounds in python development and usage - use the following guidelines to determine where to start in the documentation:
8
8
9
9
* If you are relatively comfortable working with python, visit the [Quickstart Guide](quickstart.md).
10
10
* If you would like more explicit, step-by-step instructions for:
Copy file name to clipboardExpand all lines: docs/quickstart.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ To view the coverage report:
39
39
Contributions are welcome and should be merged via pull request on the `main` branch from a forked repository. Before a PR can be merged, it needs to pass the following checks:
0 commit comments