Skip to content

Conversation

@leandrodamascena
Copy link
Contributor

@leandrodamascena leandrodamascena commented Jan 5, 2026

Issue number: closes #7886

Summary

Reorganize documentation structure following Powertools TypeScript as reference. The homepage was cluttered with nested tabs and duplicated content, making navigation confusing.

Changes

  • Create dedicated docs/getting-started/install.md page with all installation options (pip, Lambda Layers, SAR, China/GovCloud regions)
  • Simplify docs/index.md to focus on features, examples, environment variables, support, and tenets
  • Add all extra dependencies to installation page (tracer, parser, validation, datamasking, datadog, kafka, redis, valkey)
  • Include regional Layer ARN tables in installation page

User experience

Please share what the user experience looks like before and after this change


By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

@leandrodamascena leandrodamascena requested a review from a team as a code owner January 5, 2026 11:34
@boring-cyborg boring-cyborg bot added the documentation Improvements or additions to documentation label Jan 5, 2026
@pull-request-size pull-request-size bot added the size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. label Jan 5, 2026
@leandrodamascena leandrodamascena changed the title docs: refactor docs page docs: reorganize homepage and create dedicated installation page Jan 5, 2026
@sonarqubecloud
Copy link

sonarqubecloud bot commented Jan 5, 2026

@leandrodamascena leandrodamascena changed the title docs: reorganize homepage and create dedicated installation page docs(homepage): reorganize homepage and create dedicated installation page Jan 5, 2026
@leandrodamascena leandrodamascena merged commit 33f2c8f into develop Jan 5, 2026
16 checks passed
@leandrodamascena leandrodamascena deleted the docs/review-docs-page branch January 5, 2026 11:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Reorganize and clean up documentation structure

2 participants