Skip to content

docs: make CONTRIBUTING match the actual project setup - #805

Merged
Irozuku merged 1 commit into
DashAISoftware:developfrom
Maarmapa:docs/contributing-al-dia
Aug 10, 2026
Merged

docs: make CONTRIBUTING match the actual project setup#805
Irozuku merged 1 commit into
DashAISoftware:developfrom
Maarmapa:docs/contributing-al-dia

Conversation

@Maarmapa

Copy link
Copy Markdown

Summary

CONTRIBUTING.rst still contains cookiecutter boilerplate that no longer
describes this project. A contributor following the development steps in order
fails at step 4, because the command it tells them to run does not exist here.


Type of Change

  • Backend change
  • Frontend change
  • CI / Workflow change
  • Build / Packaging change
  • Bug fix
  • Documentation

Changes (by file)

  • CONTRIBUTING.rst: rewrote the Development, Pull Request Guidelines and Tips
    sections so they match the repository as it is today:
    • Step 1 pointed to fork ionelmc/DashAI, the cookiecutter author's
      namespace, not this project.
    • Steps 4, 6 and Tips told contributors to run tox. There is no tox.ini
      and tox is not a dependency, so the command fails.
    • The merge checklist asked contributors to add themselves to AUTHORS.rst,
      which does not exist in the repository.
    • uv, ruff and pre-commit — all configured in the repo — were not
      mentioned at all.
    • Added a short Frontend section (yarn) and noted that PRs target develop.

Testing

Documentation only; no code or configuration is touched.

The file was rendered with docutils at halt_level=2 (warnings treated as
errors) and produced no warnings.


Notes

The replacement commands are taken from the repository's own CLAUDE.md, which
is up to date — so this only brings the human-facing guide in line with what is
already documented for agents.

The development instructions were still cookiecutter boilerplate and no
longer describe this project:

- Step 1 pointed contributors to fork ionelmc/DashAI, which is the
  cookiecutter author's namespace, not this project.
- Steps 4, 6 and the Tips section told contributors to run tox. There is
  no tox.ini and tox is not a dependency, so the command fails.
- The merge checklist asked contributors to add themselves to
  AUTHORS.rst, which does not exist in the repository.
- pre-commit, ruff and uv (all configured in the repo) were not
  mentioned at all.

Replaces them with the commands the project actually uses. Documentation
only; no code or configuration is touched.
@Irozuku
Irozuku self-requested a review August 10, 2026 16:45
@Irozuku
Irozuku merged commit 7359a70 into DashAISoftware:develop Aug 10, 2026
15 checks passed
@Maarmapa

Maarmapa commented Aug 10, 2026 via email

Copy link
Copy Markdown
Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants