Skip to content

Final documentation and submission cleanup #12

Closed

Description

@FriggemannMichael

Objective:
Prepare the repository for final submission.

Acceptance criteria:

  • README accurately describes setup, checks, and known project behavior.
  • requirements.txt is complete and reproducible.
  • Database and local files are not tracked.
  • No commented-out code, print debugging, or unrelated files remain.
  • Ruff, Django checks, and tests pass from the local virtual environment.
  • docs/checkliste.md and docs/endpoints.md are reviewed against the implementation.

Activity

  1. added
    documentationImprovements or additions to documentation
    planned-taskPlanned project implementation task
    area:setupProject setup, structure, and configuration
    tddTest-driven development: write or define tests before implementation
    on Jun 30, 2026
  2. FriggemannMichael commented on Jun 30, 2026

    @FriggemannMichael
    OwnerAuthor

    TDD workflow for this project:

    • Define the expected behavior before implementing the endpoint or model behavior.
    • Write or outline the failing test first.
    • Implement only enough code to make that test pass.
    • Refactor after the test passes.
    • Keep Django check, Ruff, and the relevant tests green from the local virtual environment.
  3. FriggemannMichael commented on Jul 6, 2026

    @FriggemannMichael
    OwnerAuthor

    Follow-up bugs found during the docs-vs-implementation review (see acceptance criterion "docs/checkliste.md and docs/endpoints.md are reviewed against the implementation"). Tracked separately so this issue stays a clean submission checklist:

  4. FriggemannMichael commented on Jul 7, 2026

    @FriggemannMichael
    OwnerAuthor

    Submission cleanup complete — closing summary. All acceptance criteria met:

    • README rewritten with a project overview, feature list, user-type/auth notes, and accurate project structure (Rewrite README with project overview and features #35).
    • requirements.txt pinned and reproducible — pip freeze matches the file (Pin missing type-stub dependencies in requirements.txt #36).
    • Database and local files are not tracked; .gitignore covers db.sqlite3, .venv/, media/, staticfiles/, IDE and env files (verified clean).
    • No print() debugging, commented-out code, or unrelated files remain (verified clean).
    • Ruff (incl. D101), Django checks, and pytest all pass locally; coverage ~99%.
    • docs/endpoints.md is cross-checked against the implementation by the contract test (no remaining xfail markers).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:setupProject setup, structure, and configurationdocumentationImprovements or additions to documentationplanned-taskPlanned project implementation tasktddTest-driven development: write or define tests before implementation

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions