Back to all reviewers

Add explanatory tooltips

PostHog/posthog
Based on 3 comments
TSX

When UI elements have unclear functionality or purpose, add tooltips to provide immediate context and explanation. This is especially important for icons, checkboxes, and interactive elements where the behavior or consequences aren't immediately obvious to users.

Documentation TSX

Reviewer Prompt

When UI elements have unclear functionality or purpose, add tooltips to provide immediate context and explanation. This is especially important for icons, checkboxes, and interactive elements where the behavior or consequences aren’t immediately obvious to users.

Tooltips should:

  • Explain what the element does in clear, user-friendly language
  • Describe any non-obvious consequences or behaviors
  • Use terminology consistent with the rest of the UI
  • Link to documentation when appropriate (though some tooltip implementations only support strings)

Example from the discussions:

<LemonCheckbox
    checked={!!filter.optionalInFunnel}
    onChange={(checked) => {
        updateFilterOptional({
            ...filter,
            optionalInFunnel: checked,
            index,
        })
    }}
    label="Optional step"
    tooltip="When checked, this step won't cause users to drop out of the funnel if they skip it"
/>

This practice improves user experience by providing inline documentation that helps users understand functionality without needing to consult external documentation or guess at behavior.

3
Comments Analyzed
TSX
Primary Language
Documentation
Category

Source Discussions