Skip to content

docs/booking 07 & 08 are stale against current reschedule/cancel behavior (audit C10) #1013

Description

@teetangh

Context

Two booking docs now contradict the code in load-bearing ways. docs/booking/07-rescheduling-flow.md claims concurrent reschedules are harmless and predates both the stale-tab race (audit R2) and the cleanup-grace fix; docs/booking/08-cancellation-flow.md still describes delete-on-cancel, no authentication, and no automatic refunds, all three of which are false against the current cancel route (app/api/appointments/[appointmentId]/cancel/route.ts:119-155, 262-287, 303-357).

Proposed approach

Rewrite the stale sections of both chapters against the current routes and the lifecycle-correctness PR, and add the audit's reschedule/cancellation findings register so the docs point at the open issues rather than asserting solved behavior. Full-sentence prose per the docs convention.

Audit id C10/R8-doc; found alongside #998.

Activity

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

    bookingBooking, scheduling, slots, reschedule, cancellationdocumentationImprovements or additions to documentationlaunch: post-mvpFirst 90 days after launch — coverage, polish, operational maturity

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions