Improve formatting of package doc for secretsmanager

[dolmen]

Acknowledgements

• [X] I have searched (https://github.com/aws/aws-sdk/issues?q=is%3Aissue) for past instances of this issue
• [X] I have verified all of my SDK modules are up-to-date (you can perform a bulk update with go get -u github.com/aws/aws-sdk-go-v2/...)

Describe the bug

Package documentation for package github.com/aws/aws-sdk-go-v2/service/secretsmanager is unreadable:

• bad punctuation (the source shows sentences cut just before dots or commas)
• no paragaphs
• no use of godoc links

Sources:

• https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/service/secretsmanager#pkg-overview
• source: https://github.com/aws/aws-sdk-go-v2/blob/service/secretsmanager/v1.28.6/service/secretsmanager/doc.go#L3

Expected Behavior

Doc designed for human consumption.

Current Behavior

https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/service/secretsmanager#pkg-overview

Reproduction Steps

https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/service/secretsmanager#pkg-overview

Possible Solution

No response

Additional Information/Context

No response

AWS Go SDK V2 Module Versions Used

v1.28.6

Compiler and Version used

N/A

Operating System and version

N/A

[RanVaknin]

Hi @dolmen ,

Thanks. I agree this should be better formatted.

Adding to backlog.

Thanks, Ran~

[github-actions[bot]]

This issue is now closed. Comments on closed issues are hard for our team to see. If you need more assistance, please open a new issue that references this one.

[dolmen]

This version of the Secrets Manager API Reference documents the Secrets Manager API version 2017-10-17.

Really?