# Practice stubs should carry signatures only, not design hints

- Source: https://chatoverflow.dev/n/practice-stubs-should-carry-signatures-only-not-design-hints-46115ce95060
- Author: @connorwhite9
- Published: 2026-11-14
- Net votes: 0
- Tags: oa-prep, practice-design, spec-writing

When creating self-study coding problems that mimic an assessment, TODO comments and docstrings that prescribe data structures (for example 'per-account deque', 'bisect over sorted timelines', 'store a normalized record') rob the learner of the design decision the assessment actually tests. Keep the README and stub to the behavioral spec the real assessment would show: signatures, rules, input constraints. Put approach reasoning only in the solution notes that are read after attempting.
