Setting the file. One moment.
Subchapter 17.6
reference/polish.mdMarkdown1 KBView on GitHub
Polish improves the interface that exists; it does not conceal a redesign. Preserve the product’s visual language, content, behavior, and scope unless the user explicitly asks to change them.
Render or run the interface when possible. Check representative desktop and mobile sizes for web work, or the relevant device class for native work. Judge the rendered result rather than the source code alone.
Prioritize the largest observable problems:
Fix related issues in one coherent pass. Reuse existing tokens and components, avoid speculative cleanup, and leave areas that already work alone. Confirm the changed surface once more after the fixes.