Skip to content

SOLR-18352: Improve DX by more accurately communicating deprecated code status - #4750

Merged
epugh merged 19 commits into
apache:mainfrom
epugh:SOLR-18352
Aug 28, 2026
Merged

SOLR-18352: Improve DX by more accurately communicating deprecated code status#4750
epugh merged 19 commits into
apache:mainfrom
epugh:SOLR-18352

Conversation

@epugh

@epugh epugh commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

https://issues.apache.org/jira/browse/SOLR-18352

Description

Expand our @deprecated tag details with more info.

Solution

Mostly mechnaical work with claude, use git history to figure out when a deprecation was added, and then use that for the since tag. Look for git histories to help understand what replaced deprecated code if that is available.

Tests

existing

@dsmiley dsmiley left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please reduce the scope to the PR title.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Arguably this entire package can be seen as having a consistent status: The code is associated with "Trie" numerics. Anticipated to be fully resolved (replacements) for Solr 11. @HoustonPutman is leading the way here with progress.

Maybe the BBox stuff could separately be decoupled from that and be ported to Points + NumericDocValues but someone has not undertaken that.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think that if you created a nice JIRA for that, then it COULD be.... I don't know enough about BBox to say.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These deprecated methods were deprecated on 10.0; look at branch_10_0 to see for yourself. Thus we may remove them anytime in 10.x. 9.x had no alternative so devs that worked on this didn't deprecate there.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i thought if we deprecated on 10, then we remove on 11? I will go back and check the deprecation tags for the 10 versus 10.1...

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Arguably we could have just removed/changed those methods outright in a major version. It's a major version, after all!

Comment thread AGENTS.md Outdated
Comment thread solr/core/src/java/org/apache/solr/schema/TrieDateField.java Outdated
@epugh

epugh commented Aug 19, 2026

Copy link
Copy Markdown
Contributor Author

I will aim to get this merged tomorrow against main. I will see if it can be backported to branch_10x or not. But I think it puts most of it's value by being on main.

@epugh
epugh requested a review from dsmiley August 27, 2026 00:25
@epugh

epugh commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

@dsmiley re-requesting review, I have borught this up to date and tweaked some of the language...

@dsmiley dsmiley left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1 from me, just looking at your last few commits separately. For some reason, GitHub is not able to show the diffs from the last merge base; instead it's showing the changes from the merge as if you had done them -- which is impossible to effectively review (80% other stuff, 20% your changes) on an already big PR.

Note: Since you are doing this against main, you are running into things getting removed and so you're removing the comments. Had this been on 9x, we'd been able to keep those comments. The forward port process would naturally remove what doesn't exist on higher versions.

@github-actions github-actions Bot added the tests label Aug 28, 2026
public void setUp() {
MockitoAnnotations.initMocks(this);

// handleItem() probes the cluster through the state provider, so the mock must supply one

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the minimum to get the unit tests to pass... However, I am opening on up a new seperate PR that does a better job of handling Mocks for the crossdc manager tests.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a better fix: #4823

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You caught the reason why CI was failing & fixed; thanks. I hate mocks -- returning null when the real thing would never do that

@epugh

epugh commented Aug 28, 2026

Copy link
Copy Markdown
Contributor Author

tests pass locally now.

@epugh epugh added this to the 10.x milestone Aug 28, 2026
@epugh
epugh merged commit 5352b58 into apache:main Aug 28, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants