[ECD 11/21] Use DocC to produce documentation

[epau]

Describe the feature

Previously we had used swift-doc for producing documentation. That project has since been archived and no longer maintained. We should use DocC to generate our docs.

Use Case

N/A

Proposed Solution

No response

Other Information

No response

Acknowledgements

• I may be able to implement this feature request
• This feature might incur a breaking change

[epau]

• Setup using DocC for generating docs
• Modify generate docs script to use DocC
• Setup github action (CI) to run doc script manually
• Add line item to release runbook to generate docs

[epau]

Verify documentation for public code in all extensions is also generated and co-located with the extended type
#551

[epau]

Blocked until we figure out next steps regarding generating docs.

[aalviggi]

Hi - Please ensure the 6 Swift violations mentioned in https://quip-amazon.com/DaSJAa0p2BkC/SDK-Accessibility-Audit-2022#temp:C:YYV04ab72c49696447c82cfc8235 are addressed by this

[epau]

Most of the work is done here (for context talk to @ganeshnj or @epau ) but there are a few quirks that need to be ironed out

[ganeshnj]

For reference #757

[shepazon]

FWIW I am getting tickets in the documentation issue queue about the reference being missing and about links to the reference being broken. It would be really helpful for me to at least have a rough timeframe as to when the reference will return.

[jbelkins]

Released in AWS SDK for Swift 0.32.0