Skip to content

New ZRANGESTORE and ZRANGE new args, deprecate others#1482

Merged
oranagra merged 5 commits intoredis:masterfrom
oranagra:zrangestore
Jan 7, 2021
Merged

New ZRANGESTORE and ZRANGE new args, deprecate others#1482
oranagra merged 5 commits intoredis:masterfrom
oranagra:zrangestore

Conversation

@oranagra
Copy link
Member

@oranagra oranagra commented Jan 1, 2021

i'm not very comfortable with how this came out.
documenting all the nuances and instructions of BYSCORE / BYLEX / BYRANK in one page can make it quite complex.
instead i added a note to refer to the documentation of the deprecated commands for details (which sounds like a bad idea).
maybe that's a hint that this change is all wrong?
i.e. there are a lot of details about inclusive / exclusive searches and how the lexicographic ordering works, maybe unifying them into one command is wrong?

@oranagra oranagra force-pushed the zrangestore branch 2 times, most recently from 92bd6cc to f3ad6cd Compare January 1, 2021 18:50
@oranagra
Copy link
Member Author

oranagra commented Jan 4, 2021

@itamarhaber i merged your PR (oranagra#1) and added another commit, please have a look.

I see not all the content from the ZRANGEBYSCORE and ZRANGEBYLEX pages was copied into the ZRANGE page.
so if we some day completely remove the pages about ZRANGEBYSCORE and ZRANGEBYLEX, some fine details will be missing.

i guess it's a good compromise, doesn't include all the details of the separate pages, but also better than what i did, adding at least some basic info, while still also referring to the other page
maybe we should add some text saying "please look at the <deprecated command" for more details" ?

do you think that's good to go now?

Copy link
Member

@itamarhaber itamarhaber left a comment

Choose a reason for hiding this comment

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

I'm comfortable with it as is.

My intent was to include as many details as possible about each variant, without too much clutter. Other than patterns, I hope I included everything.

WRT to missing patterns: once we overhaul the docs, I think patterns should be moved out of specific commands' man pages, and into a "pattern/use case" topic thing.

@oranagra oranagra merged commit 361b855 into redis:master Jan 7, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants