Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/check_docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -34,9 +34,9 @@ jobs:
- name: Install nipanel (with docs)
run: poetry install -v --only main,docs
- name: Generate docs
run: poetry run sphinx-build docs docs/_build -b html -W --keep-going
run: poetry run sphinx-build docs docs/_build -b html -W
- name: Upload docs artifact
uses: actions/upload-artifact@v4
with:
name: nipanel-docs
path: docs/_build/
path: docs/_build/
29 changes: 26 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Contributing to nipanel-python
# Contributing to nipanel-python

Contributions to nipanel-python are welcome from all!

Expand Down Expand Up @@ -26,7 +26,30 @@ This is the command to generate the files in /src/ni/pythonpanel/v1/:

# Testing

- TODO: include testing steps here.
## Simple development loop

```
# Create a new branch
git fetch
git switch --create users/{username}/{branch-purpose} origin/main

# Install the project dependencies
poetry install --with docs

# ✍ Make source changes

# Run the analyzers -- see files in .github/workflows for details
poetry run nps lint
poetry run mypy
poetry run bandit -c pyproject.toml -r src/nipanel

# Run the tests
poetry run pytest -v

# Build and inspect the documentation
poetry run sphinx-build docs docs/_build --builder html --fail-on-warning
start docs\_build\index.html
```

# Developer Certificate of Origin (DCO)

Expand Down Expand Up @@ -59,4 +82,4 @@ This is the command to generate the files in /src/ni/pythonpanel/v1/:
(taken from [developercertificate.org](https://developercertificate.org/))

See [LICENSE](https://github.com/ni/<reponame>/blob/main/LICENSE)
for details about how \<reponame\> is licensed.
for details about how \<reponame\> is licensed.