feat: make return RecordMetada if not no_confirm, change annotations and convert Doc to doc string.

[spataphore1337]

Description

If the publish and publish_batch method is called on Kafka with the no_confirm parameter, RecordMetadata will be returned. Also corrected annotations to match the new return type of publishers, and Doc annotations have been converted to doc string.

Type of change

Please delete options that are not relevant.

• Documentation (typos, code examples, or any documentation updates)
• Bug fix (a non-breaking change that resolves an issue)
• New feature (a non-breaking change that adds functionality)
• Breaking change (a fix or feature that would disrupt existing functionality)
• This change requires a documentation update

Checklist

• My code adheres to the style guidelines of this project (scripts/lint.sh shows no errors)
• I have conducted a self-review of my own code
• I have made the necessary changes to the documentation
• My changes do not generate any new warnings
• I have added tests to validate the effectiveness of my fix or the functionality of my new feature
• Both new and existing unit tests pass successfully on my local environment by running scripts/test-cov.sh
• I have ensured that static analysis tests are passing by running scripts/static-analysis.sh
• I have included code examples to illustrate the modifications

[Lancetnik]

Looks good, but you forgot:

1. correct broker.publish and broker.publish_batch annotations
2. add test, validating broker.publish result type
   Also, you have some conflicts with 0.6.0 branch you should solve before merge