Co-authored-by: Powertools for AWS Lambda (Java) Bot <151832416+aws-powertools-bot@users.noreply.github.com>

* Add versioning plugin for docs and update workflows.

* Add old version banner override. Remove preview wording.

* chore(ci): Make v2 the main branch

* update runner size for release

* update skip checks

* create tag instead of release

…ng root-level _aws dict (#1891)

* fix(metrics): Do not flush when no metrics were added to avoid printing root-level _aws dict.

* Fix pmd linting failures.

* Add initial code for KafkaJson and KafkaAvro request handlers.

* Add deserialization via @Deserialization annotation.

* Add TODOs in code.

* Fix typos and make AbstractKafkaDeserializer package private.

* Remove request handler implementation in favor for @Deserialization annotation.

* Parse Timestamp type correctly.

* Remove custom RequestHandler implementation example.

* Make AspectJ version compatible with min version Java 11.

* Clarify exception message when deserialization fails.

* Add more advanced JSON escpaing to JSONSerializer in logging module.

* Add protobuf deserialization logic and fully working example.

* Add Maven profile to compile a JAR with different dependency combinations.

* Add minimal kafka example.

* Add missing copyright.

* Add unit tests for kafka utility.

* Add minimal kafka example to examples module in pom.xml.

* Add some comments.

* Update powertools-examples-kafka with README and make it more minimalistic. Remove powertools-examples-kafka-minimal.

* Implement PR feedback from Karthik.

* Fix SAM outputs.

* Do not fail on unknown properties when deserializating into KafkaEvent.

* Allow customers to bring their own kafka-clients dependency.

* Add Kafka utility documentation.

* Update project version consistently to 2.0.0.

* fix: Fix bug where abbreviated _HANDLER env var did not detect the Deserialization annotation.

* fix: Bug when trying to deserialize a type into itself for Lambda default behavior. We can just return the type itself. Relevant for simple String and InputStream handlers.

* When falling back to Lambda default, handle conversion between InputStream and String.

* Raise a runtime exception when the KafkaEvent is invalid.

* docs: Announce deprecation of v1

* fix(metrics): Do not flush when no metrics were added to avoid printing root-level _aws dict (#1891)

* fix(metrics): Do not flush when no metrics were added to avoid printing root-level _aws dict.

* Fix pmd linting failures.

* Rename docs to Kafka Consumer and add line highlights for code examples.

* Fix Spotbug issues.

* Reduce cognitive complexity of DeserializationUtils making it more modular and representing handler information in a simple HandlerInfo class.

* Reduce cognitive complexity of AbstractKafkaDeserializer.

* Enable removal policy DESTROY on e2e test for kinesis streams and SQS queues to avoid exceeding account limit.

* Replace System.out with Powertools Logging.

* Add notice about kafka-clients compatibility.

* Add sentence stating that Avro / Protobuf classes can be autogenerated.

* fix(kafka): Add support for confluent message indices.

* Make Generator classes non-instantiable (they are static utility classes).

* Make generator classes final.