Todo Comment (ARCH3183)

Key typescript.quality.todo-comment · Severity info · Category quality

TODO/FIXME/HACK/XXX markers in code signal unfinished work. They should be resolved before merge or tracked in an issue tracker; otherwise they become permanent technical debt in the code.

Incorrect

function calculateDiscount(user: User): number {
  // TODO: apply discount based on loyalty tier
  // FIXME: guard against negative values
  return 0;
}

Correct

function calculateDiscount(user: User): number {
  if (user.loyaltyTier === "gold") return 0.15;
  if (user.loyaltyTier === "silver") return 0.05;
  return 0;
}

Fix

Complete the work or convert the comment into a tracked issue.