Add comprehensive documentation to set commands

[iamamirsalehi]

Add comprehensive documentation to set commands

Summary

This PR adds detailed documentation to all set command methods in set_commands.go to improve developer experience and code discoverability.

Changes

• Added interface documentation for SetCmdable explaining its purpose
• Added comprehensive documentation to all 20 set command methods:
  • SAdd - Add members to a set
  • SCard - Get set cardinality
  • SDiff - Set difference operation
  • SDiffStore - Store set difference result
  • SInter - Set intersection operation
  • SInterCard - Get intersection cardinality
  • SInterStore - Store set intersection result
  • SIsMember - Check membership
  • SMIsMember - Check multiple memberships
  • SMembers - Get all members (slice)
  • SMembersMap - Get all members (map)
  • SMove - Move member between sets
  • SPop - Pop random member
  • SPopN - Pop multiple random members
  • SRandMember - Get random member
  • SRandMemberN - Get multiple random members
  • SRem - Remove members
  • SScan - Incrementally scan set
  • SUnion - Set union operation
  • SUnionStore - Store set union result

Documentation Details

Each method now includes:

• The corresponding Redis command syntax
• Clear description of what the command does
• Parameter explanations (especially for SScan)
• Return value descriptions
• Edge case behavior (e.g., handling of non-existent keys)

Benefits

• Improved IDE autocomplete experience with inline documentation
• Better understanding of method behavior without consulting external docs
• Clearer parameter usage, especially for complex operations like SScan
• Consistent documentation style matching other command files in the codebase

Testing

• No functional changes - documentation only

[jit-ci]

Hi, I’m Jit, a friendly security platform designed to help developers build secure applications from day zero with an MVS (Minimal viable security) mindset.

In case there are security findings, they will be communicated to you as a comment inside the PR.

Hope you’ll enjoy using Jit.

Questions? Comments? Want to learn more? Get in touch with us.

[ndyakov]

Hello @iamamirsalehi, thank you for this contribution. I will review it as soon as possible.

[iamamirsalehi]

Hello @ndyakov, Thank you for reviewing. I’ll add more documentation for the other methods if you find it useful.

[ndyakov]

@iamamirsalehi thank you for this initiative once again!
One comment that should be addressed:

In the comments for a given command, it will be useful if we provide link to the official documentation on redis.io. You can take a look at:

go-redis/search_commands.go

Line 594 in f711eb0

// [FT._LIST]: (https://redis.io/commands/ft._list/)

and read about links in godoc:
https://go.dev/doc/comment#links

Consider this a pr wide comment, we can add such links to all comments.

[iamamirsalehi]

@ndyakov Thank you for reviewing. Sure, I'll apply it to all comments

[iamamirsalehi]

Hi @ndyakov, thanks for your feedback, I applied the changes, could you please review it again. After your confirm, I'll write doc for other command files too, and make a PR for each of them.