When updating technical documentation, ensure it is operationally accurate across supported platforms and matches the actual behavior of the software.
Apply this standard:
~, home directories, or filesystem paths, confirm how that expands on each supported OS (e.g., Windows user/profile vs roaming profile behavior). If ambiguity exists, document the concrete path(s) or provide OS-specific examples.--help, command parsing, and tests). Don’t include flags/options that are “accepted but ignored”; remove or correct them.Example (behavior-faithful option table + example):
# Doc should only list options that actually work
cline history --json --limit 10
# If an option was removed or ignored, update the docs accordingly
# (e.g., remove the option row rather than saying it’s ignored)