Skip to content

feat(docs): add onboarding Storybook MDX docs (#612)#613

Open
MichaelLarocca wants to merge 1 commit intodevelopfrom
michaelL/612-storybook-onboarding-mdx-docs
Open

feat(docs): add onboarding Storybook MDX docs (#612)#613
MichaelLarocca wants to merge 1 commit intodevelopfrom
michaelL/612-storybook-onboarding-mdx-docs

Conversation

@MichaelLarocca
Copy link
Copy Markdown

Description

Before:

No onboarding documentation was available in Storybook. New contributors lacked a centralized place for project onboarding, standards, and technical references.

After:

Added onboarding documentation sections to Storybook using MDX files. Created the following docs in stories/onboarding/:

  • Welcome
  • Onboarding
  • Tech Stack
  • CloneWithGit
  • CloneWithGitKraken
  • Backend
  • ProjectStructure

Updated Storybook config to ensure all onboarding docs are included in the sidebar. This provides a clear, accessible onboarding resource for new and existing team members.

Closes #612

Testing instructions

  1. Pull this branch and install dependencies if needed.
  2. Run pnpm storybook.
  3. Open http://localhost:6006 in your browser.
  4. Verify that all onboarding docs appear in the sidebar under the appropriate sections and render correctly.

Additional information

  • Placeholder content is included; team members can now add detailed onboarding info.
  • No breaking changes to existing stories or components.

[optional] Screenshots

Pre-submission checklist

  • Code builds and passes locally
  • PR title follows Conventional Commit format (e.g. feat(docs): add onboarding Storybook MDX docs (#612))
  • Request reviews from the Peer Code Reviewers and Senior+ Code Reviewers groups
  • Thread has been created in Discord and PR is linked in gis-code-questions
StoryDocsOnboarding

@vercel
Copy link
Copy Markdown

vercel Bot commented Sep 16, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
elecretanta Ready Ready Preview Comment Sep 16, 2025 5:30pm
elecretanta-storybook Ready Ready Preview Comment Sep 16, 2025 5:30pm
elecretanta-unit-test Ready Ready Preview Comment Sep 16, 2025 5:30pm

@shashilo shashilo requested review from a team September 16, 2025 17:30
Copy link
Copy Markdown
Collaborator

@alexappleget alexappleget left a comment

Choose a reason for hiding this comment

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

LGTM

@@ -0,0 +1,3 @@
# Clone With Git
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

We can consolidate the Clone with Git and CloneWithGitGraken files (e.g. "Cloning the Project")

Copy link
Copy Markdown
Member

@nickytonline nickytonline left a comment

Choose a reason for hiding this comment

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

Just some general feedback. Storybook is primarily used for showcasing components, design system related stuff, tests (if you leverage them in Storybook). Most of what's in this PR is OK, but it's not a replacement for a projects README/setup guide..

Clone with Git/Clone with GitKraken are better suited for a README or setup guide. Same for the Backend section since Storybook is mainly for frontend.

Thoughts @shashilo?

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.

Add onboarding documentation sections to Storybook using MDX

4 participants