leboncoin/spark-android

[FR]: Clarify Legacy API label in Buttons.md or add @Deprecated

Open

#2,125 opened on Jul 27, 2026

View on GitHubContributor guide
 (0 comments) (0 reactions) (0 assignees)Kotlin (31 forks)auto 404
componentcontribution welcomeddocumentationgood first issuepriority:LOW

Repository metrics

Stars
 (85 stars)
PR merge metrics
 (Avg merge 4d 9h) (73 merged PRs in 30d)

Description

Describe the problem

Buttons.md frames ButtonFilled, ButtonOutlined, ButtonTinted, ButtonGhost, ButtonContrast as "Legacy API". None carry a @Deprecated annotation. Calling them "legacy" may discourage use of fully supported APIs.

Describe the solution

Either add @Deprecated annotations to the source with replaceWith guidance, or rename the doc section to "Alternative API" and clarify the relationship.

Additional context

Priority: Low. Effort: XS.

Contributor guide

Research direction
Locate the Buttons.md file and the source code for ButtonFilled, ButtonOutlined, ButtonTinted, ButtonGhost, ButtonContrast. Determine whether to add @Deprecated annotations with replaceWith guidance or rename the doc section to 'Alternative API' and clarify the relationship.
Tech stack
kotlinandroid
Domain
mobile
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GitKotlin
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80