odoo/documentation#20031

Created by fw-bot

label

odoo-dev:saas-19.1-19.0-down-payment-correction-thjud-563165-fw

head

d034c7ca9252b9bc780209fec443a694e262804b

merged

2 days ago by Thomas Jude Cavazos (thjud)

[IMP] Sales: Corrected/improved outdated Down Payments page

What this PR does and why it's needed

Corrects and updates the Sales Down payments page, which contained outdated and confusing
content, based on user feedback. Fixes inaccurate/redundant explanations of down payment behavior,
cleans up UI-reference markup for consistency, and adds an LLM-readable meta description to the page.

Changes

Content corrections
- Clarified the explanation of 100% down payments, replacing a duplicated/confusing pair of
paragraphs with a single accurate statement that another invoice is still required to complete
the sales order.
- Removed an outdated claim that a down payment account can be set on a product category and
prioritized for future down payments, which no longer reflects current behavior.
- Minor wording corrections throughout (e.g. "fixed dollar amounts and partial percentage down
payments" instead of "fixed amounts and partial down payments").

Markup consistency
- Standardized references to pop-up windows, tabs, and form titles (e.g. Create invoice(s),
Invoice Lines, Order Lines, Pay, Search: Account) to italics instead of :guilabel:,
reserving :guilabel: for actual clickable buttons and fields.

Discoverability
- Added a .. meta:: description to the page summarizing down payment invoicing (fixed vs.
percentage), examples, and income account modification, for LLM readability.

This 19.0 PR can be FWP up to master.

Forward-Port-Of: #19888