Sentinel commands documentation

[vendelieu]

While looking into commands documentation got curious why isn't there documentation for sentinel commands as for cluster ones, sometimes is tricky to know how should I work with them :\

I know that there's information about sentinels within specific page.

But would be great to have them like for cluster commands.

Also small favor to ask, I noticed you moved response "specification" from json in data folder to content folder inside of md files, I was using them and other jsons in data folder as for reference and for validation of my client library,
It would be great to have them back somehow (now I'm turned to using old version of repo before change but in future expect it to get outdated so really sad about regex parsing of md files perspective).
Absolutely awesome would be to have more ... machine readable response information instead of "one of ..." kind.

[dwdougherty]

Hi @vendelieu. Thank you for reaching out. I'll ask PM about the sentinel commands. They've never been there for my entire tenure at Redis, so I suspect their absence is intentional.

Regarding return values, having them in two JSON files in the data directory was only a short-term workaround for when we added RESP3 information to the site. If you want "machine readable" information, have a look at the reply_schema information in each command's JSON file:

https://github.com/redis/redis/tree/unstable/src/commands

[dwdougherty]

Hi @vendelieu. I just spoke to my PM and the verdict is that we're not going to add sentinel command pages at this time.

[vendelieu]

Hey @dwdougherty, big thanks for pointing to reply_schema, that would be very helpful!

And for sentinel commands that's sad, but is there in future any plans? As workaround I created some kind of schema manually

[dwdougherty]

You're welcome. There are no future plans that I am aware of around adding sentinel command docs.