r/s3_bucket_lifecycle_configuration: improve documentation and officially deprecate prefix

[anGie44]

Community Note

• Please vote on this pull request by adding a 👍 reaction to the original pull request comment to help the community and maintainers prioritize this request
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for pull request followers and do not help prioritize the request

Closes #23299
Relates #23228

Description:

• The prefix argument is deprecated as suggested in the documentation; AWS has already announced its deprecation.
• The resource documentation examples are enhanced to encourage filter use and provide more specifics on how to use filtering based on use-case

Output from acceptance testing:

N/A

[ewbankkit]

LGTM 🚀.

% make testacc TESTARGS='-run=TestAccS3BucketLifecycleConfiguration_basic\|TestAccS3BucketLifecycleConfiguration_prefix' PKG=s3    
==> Checking that code complies with gofmt requirements...
TF_ACC=1 go test ./internal/service/s3/... -v -count 1 -parallel 20  -run=TestAccS3BucketLifecycleConfiguration_basic\|TestAccS3BucketLifecycleConfiguration_prefix -timeout 180m
=== RUN   TestAccS3BucketLifecycleConfiguration_basic
=== PAUSE TestAccS3BucketLifecycleConfiguration_basic
=== RUN   TestAccS3BucketLifecycleConfiguration_prefix
=== PAUSE TestAccS3BucketLifecycleConfiguration_prefix
=== CONT  TestAccS3BucketLifecycleConfiguration_basic
=== CONT  TestAccS3BucketLifecycleConfiguration_prefix
--- PASS: TestAccS3BucketLifecycleConfiguration_basic (195.87s)
--- PASS: TestAccS3BucketLifecycleConfiguration_prefix (195.96s)
PASS
ok  	github.com/hashicorp/terraform-provider-aws/internal/service/s3	200.064s

[github-actions]

This functionality has been released in v4.3.0 of the Terraform AWS Provider. Please see the Terraform documentation on provider versioning or reach out if you need any assistance upgrading.

For further feature requests or bug reports with this functionality, please create a new GitHub issue following the template. Thank you!

[github-actions]

I'm going to lock this pull request because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.
If you have found a problem that seems related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.