Skip to content

Introduce a style guide #11

@ianakotey

Description

@ianakotey

Description

The codebase currently lacks a documented style guide and consistent formatting/linting configuration. This can lead to inconsistent code when others want to make changes, and can create useless maintenance work if people have different formatters that just rearrange code due to individual preferences.

Proposal

  • Add a style guide (e.g., based on PEP 8) to the repository.
  • Configure automated formatting tools (such as Black or isort) and linters (such as Flake8 or pylint) to enforce consistency.
  • Document the configuration and usage in the README.

Recommendation:

  • Update the master branch with some linting and formatting rules to ensure consistency among contributors.
    Use a pyproject.toml file to centralize and manage tool configurations for formatting and linting.

Example tools to consider:

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions