Skip to content
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

docs: Add Storybook documentation landing page #334

Merged
merged 11 commits into from
May 25, 2023

Conversation

JanHamara
Copy link
Contributor

@JanHamara JanHamara commented May 19, 2023

What:
Adds main landing page for the Storybook navigation (includes navigation to some of the most essential parts of the new documentation in SB)

Why:
We've put quite a lot of effort into migrating our old docs into Storybook.

While Storybook is a great tool for documentation, isolated-development, testing of components, etc. many top companies worldwide and their design systems use a combination of Storybook and a separate documentation website (that links to Storybook, Figma, repository source code, and more) to fulfil their documentation purposes.

That could include:

  • Page for component statuses (e.g. https://orbit.kiwi/component-status/)
  • Changelogs
  • Sharing docs for themeable design system, e.g. multiple color schemes (which will be case for us soon, due to rebranding)
  • Design patterns docs
  • How-to guides, migration guides, theming guides
  • Library Hooks documentation
  • Linking to Bug Reporting, Figma UI Kit, etc.
  • Accessibility docs, Page for contributors community, Sandbox / Playground (not same thing as SB Canvas)

Some examples:

Anyways, we don't currently have available time and effort to develop such sophisticated documentation website, but this MR should be sort of an indicator of effort to integrate a bit of a more visual documentation and better look into our Storybook, on which we can develop later.

How:

  • Uses Wave components to build up the welcome landing page on our Storybook documentation.
  • Links to some of the most essential parts of docs for both newcomers and current users of the library (Colors, Typography, Spacing, Components, Icons, etc.).
  • Provides a quick link to Bug Report page on Wave Github repo
  • Provides a link to our Wave Figma file
  • Highlights the ability to utilise the search functionality in SB with hotkey

Media:
Screenshot 2023-05-19 at 14 50 49

Screenshot 2023-05-19 at 14 51 30

Checklist:

  • Review the design
  • Ready to be merged

Martí Malek and others added 9 commits May 12, 2023 14:11
Docz is not supported anymore. We decided to migrate to a stable solution

Co-authored-by: Zack Jones <[email protected]>
Co-authored-by: Nikolai Lopin <[email protected]>

docs: migrate components to storybook part 1 (#313)

Components migrated:
* Accordion
* Banner
* Box
* Card

WECH-23: Migrate components to storybook part 2 (#314)

* Checkbox
* Datepicker
* Dimmer
* Divider
* Filepicker
---------

Co-authored-by: Zack Jones <[email protected]>
Co-authored-by: Cristian Sanchez <[email protected]>
Co-authored-by: Nikolai Lopin <[email protected]>

docs: migrate components to storybook

* docs: add input story

* docs: add label story

* docs: add link story

* docs: add modal story

* docs: add offcanvas story

* docs: define argTypes for Input and Label stories

* docs(password): add Password to Storybook

* docs(phoneinput): add PhoneInput to Storybook

* fix(test): update snapshots

* docs(pagination): add Pagination to Storybook

* docs(radiobutton): add RadioButton to Storybook

* docs(popover): add Popover to Storybook

---------

Co-authored-by: Aleksandar Spasov <[email protected]>
Co-authored-by: Ján Hamara <[email protected]>

migrate to storybook v7 (#323)

chore: fix failing storybook

Update typescript to the lowest supported version

docs: migrate component pages to storybook (#316)

* Input
* Label
* Link
* Modal
* Offcanvas

Co-authored-by: Aleksandar Spasov <[email protected]>
Co-authored-by: Nikolai Lopin <[email protected]>

docs: migrate components to storybook (#317)

* table
* tag
* text
* textarea
* toggle
* tooltip
---------

Co-authored-by: Christian <[email protected]>
Co-authored-by: Nikolai Lopin <[email protected]>

docs: migrate components (#320)

* Search
* TabBar
* Select
* SelectList
* Skeleton

Co-authored-by: Inga Schünemann <[email protected]>

docs: migrate essentials to storybook (#322)

* essentials pages
* Logo
* Icons
* remove IE 11 from the list of supported

---------

Co-authored-by: lena <[email protected]>
Co-authored-by: Vanessa Knibbe <[email protected]>
Co-authored-by: Nikolai Lopin <[email protected]>

docs: migrate Grid docs

ci: install with legacy in docs pipeline

docs: migrate Headline docs

docs: migrate HelperText

docs: migrate InlineSpinner

docs: migrate Infobanner docs

docs: remove unused code

docs: move accordion stories to the accordion folder

docs: move Box stories to the box folder

docs: move Button stories to the button folder

docs: moves Card stories to the card folder

docs: moves Checkbox stories to the checkbox folder

docs: moves Banner stories to the banner folder

docs: moves Dimming stories to the dimming folder

docs: moves Divider stories to the divider folder

docs: moves datepicker stories to the datepicker folder

docs: clean banner docs

docs: use new imports

docs: remove stories folder

docs: migrate Table docs to csf3

docs: migrate Input docs to csf3

docs: migrate Popover docs to csf3

docs: migrate Label docs to csf3

docs: migrate Link docs to csf3

docs: migrate Tag docs to csf3

docs: migrate Modal docs to csf3

docs: migrate Tooltip docs to csf3

docs: migrate Toggle docs to csf3

docs: migrate Textarea docs to csf3

docs: migrate Text docs to csf3

docs: show Text default values

docs: migrate Password docs to csf3

docs: migrate TabBar docs to csf3

docs: migrate RadioButton docs to csf3

docs: migrate PhoneInput docs to csf3

docs: migrate Offcanvas docs to csf3

docs: migrate FilePicker docs to csf3

docs: migrate Skeleton docs to csf3

docs: migrate Select docs to csf3

docs: align naming of doc pages

docs: migrate SelectList docs to csf3

docs: migrate Pagination docs to csf3

docs: use ArgTypes for table

ArgsTable is deprecated

docs: use consistent stories import

docs: polish docs

docs: use helper for dark background
Copy link
Contributor

@nlopin nlopin left a comment

Choose a reason for hiding this comment

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

Great work Jan! It looks awesome 🏄‍♂️

I've mentioned some issues in the review, the main things are freenow font and index.storybook.mdx. The index file has custom layout and we cannot avoid it. At the same time, we can try to reduce the markup so the text is easy to edit when needed. I've suggested the unstyled component, it could shave off some divs

Copy link
Contributor

@martimalek martimalek left a comment

Choose a reason for hiding this comment

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

Awesome work @JanHamara, it looks amazing!

@JanHamara JanHamara merged commit 10d929b into WECH-21/support-react-18 May 25, 2023
@JanHamara JanHamara deleted the feat/storybook-landing-page branch May 25, 2023 13:10
JanHamara added a commit that referenced this pull request May 25, 2023
Fix up default font for theme to Open Sans (my bad, I left behind one commit and merged in the MR before pushing it)

Relevant MR: #334
JanHamara added a commit that referenced this pull request May 25, 2023
Update 'by Freenow' SVG with one with correct font (my bad, I left behind one commit and merged in the MR before pushing it)

Relevant MR: #334
nlopin pushed a commit that referenced this pull request May 26, 2023
* feat(landing): add landing page for Storybook

* docs(landing): finish the landing page integration

* docs(theme): theme storybook with our branding

* refactor(landingpage): mr review modifs part 1

* refactor(landing): wrap landing page mdx in unstyled component

---------

Co-authored-by: Ján Hamara <[email protected]>
nlopin pushed a commit that referenced this pull request May 26, 2023
Fix up default font for theme to Open Sans (my bad, I left behind one commit and merged in the MR before pushing it)

Relevant MR: #334
nlopin pushed a commit that referenced this pull request May 26, 2023
Update 'by Freenow' SVG with one with correct font (my bad, I left behind one commit and merged in the MR before pushing it)

Relevant MR: #334
martimalek pushed a commit that referenced this pull request May 26, 2023
* feat(landing): add landing page for Storybook

* docs(landing): finish the landing page integration

* docs(theme): theme storybook with our branding

* refactor(landingpage): mr review modifs part 1

* refactor(landing): wrap landing page mdx in unstyled component

---------

Co-authored-by: Ján Hamara <[email protected]>
martimalek pushed a commit that referenced this pull request May 26, 2023
Fix up default font for theme to Open Sans (my bad, I left behind one commit and merged in the MR before pushing it)

Relevant MR: #334
martimalek pushed a commit that referenced this pull request May 26, 2023
Update 'by Freenow' SVG with one with correct font (my bad, I left behind one commit and merged in the MR before pushing it)

Relevant MR: #334
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

6 participants