Skip to content

docs: add getting started section #3818

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Apr 15, 2025
Merged

docs: add getting started section #3818

merged 6 commits into from
Apr 15, 2025

Conversation

dreamorosi
Copy link
Contributor

@dreamorosi dreamorosi commented Apr 8, 2025

Summary

Changes

Please provide a summary of what's being changed

This PR overhauls and simplifies the entry-section and menu structure of the docs to create a more cohesive onboarding experience for those who are new to the project.

Specifically:

  • simplified the homepage by a lot and left only basic info
  • added a 'Features' meta page (primarily for SEO)
  • moved environment variables to dedicated page
  • moved Lambda layers info in dedicated page under "Getting Started"
  • expanded SSM info and instructions in the same page as Lambda layers
  • added a "TypeScript settings" page under "Getting Started" to share suggested tsconfig.json
  • moved install details into dedicated "Installation" page under "Getting Started"
  • added a "Navigating the toolkit" page under "Getting Started" that explains different patterns that the lib supports (decorators, middleware, etc.)

Note

For an easier review, I have deployed this version of the docs at this preview link. If some paths don't load correctly, please checkout the branch and run locally.

Please add the issue number below, if no issue is present the PR might get blocked and not be reviewed

Issue number: closes #3799, closes #2948


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.

@dreamorosi dreamorosi self-assigned this Apr 8, 2025
@boring-cyborg boring-cyborg bot added the documentation Improvements or additions to documentation label Apr 8, 2025
@pull-request-size pull-request-size bot added the size/XXL PRs with 1K+ LOC, largely documentation related label Apr 8, 2025
Copy link

@phipag phipag left a comment

Choose a reason for hiding this comment

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

I love this new structure. Especially the dedicated page for the environment variables. We added a lot of them over time and it gives a nice overview where and how each variable applies.

@dreamorosi dreamorosi requested a review from am29d April 15, 2025 08:30
Copy link
Contributor

@leandrodamascena leandrodamascena left a comment

Choose a reason for hiding this comment

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

Hi @dreamorosi! This is great work and I'm sure it will inspire me to refactor Python documentation.

I just left 2 small comments, but feel free to ignore.

@dreamorosi dreamorosi merged commit bf5ad24 into main Apr 15, 2025
41 checks passed
@dreamorosi dreamorosi deleted the docs/getting_started branch April 15, 2025 09:01
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/XXL PRs with 1K+ LOC, largely documentation related
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Docs: add a section to explicitly explain how public SSM works Docs: Simpler Get Started Docs
4 participants