a repository to use as a template for pyprojects

8 Open Issues Need Help Last updated: Feb 24, 2026

Open Issues Need Help

View All on GitHub

AI Summary: This issue proposes automating the generation of GitHub release notes to eliminate manual writing. The solution involves configuring a `.github/release.yml` file to map conventional commit prefixes to defined changelog categories and updating the release workflow to use GitHub's built-in `gh release create --generate-notes` command or a dedicated action like `release-drafter`.

Complexity: 2/5
enhancement good first issue github_actions

a repository to use as a template for pyprojects

Python

AI Summary: This issue proposes adding a `.vscode/` directory with configuration files to enhance the developer experience in VS Code. It aims to automatically configure tools like Ruff, Mypy, and pytest, enabling features such as format-on-save, error highlighting, and test discovery without manual setup.

Complexity: 1/5
enhancement good first issue

a repository to use as a template for pyprojects

Python

AI Summary: This issue proposes the implementation of an Architecture Decision Record (ADR) system to formally document architectural choices. It outlines steps for creating a directory structure, a template for ADRs, a `doit` task for generating new ADRs, and seeding the system with existing decisions. The goal is to ensure important architectural decisions are not lost and are easily accessible.

Complexity: 2/5
documentation good first issue

a repository to use as a template for pyprojects

Python

AI Summary: This issue proposes integrating the `vulture` tool to detect and report dead code within the project. The implementation involves adding `vulture` as a dependency, configuring it with a whitelist for false positives, creating a `doit` task for analysis, integrating it into the CI pipeline, and updating documentation.

Complexity: 2/5
enhancement good first issue dependencies

a repository to use as a template for pyprojects

Python

AI Summary: This issue proposes integrating the `radon` tool to automatically detect and report code complexity metrics like cyclomatic complexity and maintainability index. The goal is to improve code quality by identifying and addressing overly complex functions, with implementation steps including dependency addition, `doit` task creation, threshold configuration, CI integration, and documentation.

Complexity: 2/5
enhancement good first issue dependencies

a repository to use as a template for pyprojects

Python

AI Summary: This issue proposes adding shell completion support for `doit` tasks in Bash and Zsh. The goal is to improve user experience by allowing tab completion of task names and displaying task descriptions, reducing the need to memorize or look up commands. The implementation involves generating completion scripts, integrating them with common shell configurations, and adding a `doit completions` command to regenerate them.

Complexity: 2/5
enhancement good first issue

a repository to use as a template for pyprojects

Python

AI Summary: This issue proposes to activate Dependabot for automated dependency updates by renaming and configuring the existing `.github/dependabot.yml.example` file. The configuration will include specific schedules for Python dependencies and GitHub Actions, dependency grouping, labeling, commit prefixes, and a PR limit. An optional auto-merge workflow for patch updates is also suggested.

Complexity: 2/5
enhancement good first issue dependencies

a repository to use as a template for pyprojects

Python

AI Summary: This issue proposes adding a new issue template specifically for documentation requests. Currently, documentation issues are miscategorized as feature requests. The solution involves creating a new YAML template with a `docs:` prefix and relevant fields, and updating the `doit` task to support a `--type=doc` option.

Complexity: 2/5
enhancement good first issue

a repository to use as a template for pyprojects

Python