Skip to content

Add Smithy Kotlin documentation#2944

Merged
kstich merged 5 commits intosmithy-lang:mainfrom
0marperez:main
Feb 3, 2026
Merged

Add Smithy Kotlin documentation#2944
kstich merged 5 commits intosmithy-lang:mainfrom
0marperez:main

Conversation

@0marperez
Copy link
Contributor

Background

Added some Smithy Kotlin documentation to the smithy.io website. Smithy Kotlin is now GA and was missing documentation.

Testing

  • make install && make html && make serve
  • ./gradlew clean build
  • Reviewed rendered changes on browser.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@github-actions
Copy link
Contributor

This pull request does not contain a staged changelog entry. To create one, use the ./.changes/new-change command. For example:

./.changes/new-change --pull-requests "#2944" --type feature --description "Add Smithy Kotlin documentation"

Make sure that the description is appropriate for a changelog entry and that the proper feature type is used. See ./.changes/README or run ./.changes/new-change -h for more information.

@0marperez 0marperez marked this pull request as ready for review January 26, 2026 16:00
@0marperez 0marperez requested a review from a team as a code owner January 26, 2026 16:01
@0marperez 0marperez requested a review from yefrig January 26, 2026 16:01

kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines-core-version" }

Add the following dependencies to your project:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd move this ahead of the version catalog.


Some of the code generated client APIs are public but marked with an `InternalApi <https://github.com/smithy-lang/smithy-kotlin/blob/main/runtime/runtime-core/common/src/aws/smithy/kotlin/runtime/Annotations.kt#L8-L31>`_
annotation to discourage client end users from using them outside of generated code.
To opt in to the InternalApi annotation, add the following to your Gradle build script:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To opt in to the InternalApi annotation, add the following to your Gradle build script:
To opt in to the ``InternalApi`` annotation, add the following to your Gradle build script:

@0marperez 0marperez requested a review from kstich February 3, 2026 15:53
@kstich kstich merged commit 8e7106a into smithy-lang:main Feb 3, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants