Problem/Motivation

docs/presentation.md omits --act-color-danger, --act-indent, --act-indent-cap, and --act-bubble-inset, the last three being the only lever a themer has for indentation. The claim that all custom properties are consumed with fallbacks is false (comment.css:42 and :62), and that is the direct cause of the escaping bubble tail in Issue F. Neither doc mentions the SDC replaces: contract, which is the only supported way to swap the card markup, so a themer reading the docs concludes it is immutable. There is also no caveat that enabling Authored by / Authored on display components on the comment view mode duplicates the card byline.

Steps to reproduce

  • Read docs/presentation.md and attempt to theme indentation or swap the card markup; note the missing tokens and the undocumented replaces: contract.

Proposed resolution

  • Document the four omitted tokens and correct the fallback claim.
  • Document the SDC replaces: contract for swapping the card markup.
  • Document the byline duplication caveat when Authored by / Authored on display components are enabled.

Remaining tasks

  • Verify the corrected claims against the current CSS.

User interface changes

None; documentation only.

API changes

None anticipated.

Data model changes

None anticipated.

AI-Generated: Yes (Used Opus 5 and DeepSeek Flash to review and discover these issues)

Comments

freelock created an issue. See original summary.

  • freelock committed e0e293f1 on 1.0.x
    task: #3623185 Documentation gaps that block theming
    
freelock’s picture

Status: Active » Fixed

Fixed.

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.