chore(batch): deprecate sqs_batch_processor

[rubenfonseca]

Issue number: #1459

Summary

Changes

Please provide a summary of what's being changed

This PR adds a deprecation warning to the sqs_batch_processor decorator and PartialSQSProcessor class.

It also adds a banner on the documentation urging customers to upgrade before the next major version.

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[rubenfonseca]

@heitorlessa I do not know if the way I've implemented the banner on the docs is the correct way to do it.

[heitorlessa]

Awesome! Two notes on repurposing announcement bar to inform customers of v2, and admonition for batch.md

[heitorlessa]

This would add an announcement for the entire documentation, we'd want under batch.md instead with admonition:

???+ warning
    our message...

This type of announcement will be super useful to let people know we're going to launch v2. So perhaps rephrase to inform them that? I think it'll also need to make it auto-hide so those who already seen don't see it again: https://squidfunk.github.io/mkdocs-material/setup/setting-up-the-header/?h=announcement#automatic-hiding

[rubenfonseca]

Moved the warning to the batch doc page, and added a banner to documentation saying "v2 is coming". As always, feedback on wording is very important to me.