Skip to content

DOC-326: Simplify README to defer to full lstk documentation#406

Merged
gtsiolis merged 1 commit into
mainfrom
doc-326-simplify-lstk-readme
Jul 24, 2026
Merged

DOC-326: Simplify README to defer to full lstk documentation#406
gtsiolis merged 1 commit into
mainfrom
doc-326-simplify-lstk-readme

Conversation

@quetzalliwrites

Copy link
Copy Markdown
Contributor

Summary

  • The README duplicated most of the comprehensive lstk reference now published at docs.localstack.cloud (config reference, full command list, snapshots, env vars, cloud CLI proxy details, etc.).
  • Trim it to what a README is for — the "front of the box," per the LEGO-box analogy on the ticket: what the tool is, how to install it, a quick start, and a short feature list — and link out to the full docs for command reference, configuration, and troubleshooting.
  • Kept links to docs/extensions-authoring.md and docs/structured-output.md (repo-local supplementary docs not duplicated on the docs site), and added a link to CONTRIBUTING.md.
  • 494 lines → ~54 lines.

Linear: https://linear.app/localstack/issue/DOC-326/simplify-lstk-readme

Test plan

  • Verified all retained links (docs.localstack.cloud lstk page, docs/extensions-authoring.md, docs/structured-output.md, CONTRIBUTING.md, GitHub releases/issues) resolve to existing content

The README duplicated most of the comprehensive lstk reference now
published at docs.localstack.cloud. Trim it to what a README is for:
what the tool is, how to install it, a quick start, and a short
feature list, linking out to the full docs for command reference,
configuration, and troubleshooting.
@quetzalliwrites
quetzalliwrites requested a review from a team as a code owner July 23, 2026 12:45
@quetzalliwrites quetzalliwrites self-assigned this Jul 23, 2026
@quetzalliwrites

Copy link
Copy Markdown
Contributor Author

ready for you @mmaureenliu !

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

LGTM 🎉 — the trim keeps the front-of-the-box essentials (install, quick start, feature list) and defers the rest to the docs site, exactly what the ticket asks; I verified every retained link resolves on main (CONTRIBUTING.md, docs/extensions-authoring.md, docs/structured-output.md) and the sole internal anchor [Installation](#installation) still matches its heading, @quetzalliwrites.

Note

This session cannot submit an approving review, so this is posted as a comment — but there are no blocking items; treat it as an approve.


Generated by Claude Code

@mmaureenliu mmaureenliu left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

That's so much neater! Thank you very much!

@anisaoshafi anisaoshafi added semver: patch docs: skip Pull request does not require documentation changes labels Jul 23, 2026
@gtsiolis

Copy link
Copy Markdown
Member

Thanks, everyone! Merging...

@gtsiolis
gtsiolis merged commit 0285470 into main Jul 24, 2026
19 of 21 checks passed
@gtsiolis
gtsiolis deleted the doc-326-simplify-lstk-readme branch July 24, 2026 11:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs: skip Pull request does not require documentation changes semver: patch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants