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

chore (refs T33323): add storybook documentation to DpTabs. #344

Merged
merged 13 commits into from
Jul 4, 2023

Conversation

ahmad-demos
Copy link
Contributor

https://yaits.demos-deutschland.de/T33323

  • add storybook documentation to DpTabs.

@ahmad-demos ahmad-demos added the documentation Improvements or additions to documentation label Jul 3, 2023
Comment on lines 43 to 62
## DpTabs Props:

```
- activeId: is a String type, belongs to data.

- tabSize: `medium` or `large`, default is `large`

- useUrlFragment: Active tab state may be persisted via an Url fragment.
Also, ab clicks are pushed to the browser history to enable state change when browser navigation is used.
```

## DpTab Props:

```
- id: Tab ID.

- label: The label is passed to the DpTab child component, but then it is used in the parent component DpTabs.

- suffix: A html string may be passed here which is appended to the tab label.
```
Copy link
Contributor

Choose a reason for hiding this comment

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

Vue component props are typically "auto-documented" by storybook using vue-docgen-api and vue-docgen-loader. At the moment the Storybook docs integraton is broken so that the props are not showing up as expected, however there is no need to document them by hand. Rather we could fill in the blanks by adding docblocks directly above the props themselves.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done 59b2c5b

src/components/DpTabs/DpTabs.stories.mdx Outdated Show resolved Hide resolved
src/components/DpTabs/DpTabs.stories.mdx Outdated Show resolved Hide resolved
src/components/DpTabs/DpTabs.stories.mdx Outdated Show resolved Hide resolved
src/components/DpTabs/DpTabs.stories.mdx Outdated Show resolved Hide resolved
src/components/DpTabs/DpTabs.stories.mdx Outdated Show resolved Hide resolved
src/components/DpTabs/DpTabs.stories.mdx Outdated Show resolved Hide resolved
src/components/DpTabs/DpTabs.stories.mdx Outdated Show resolved Hide resolved
src/components/DpTabs/DpTabs.stories.mdx Outdated Show resolved Hide resolved
ahmad-demos and others added 8 commits July 3, 2023 15:44
Co-authored-by: spiess-demos <40452344+spiess-demos@users.noreply.github.com>
Co-authored-by: spiess-demos <40452344+spiess-demos@users.noreply.github.com>
Co-authored-by: spiess-demos <40452344+spiess-demos@users.noreply.github.com>
Co-authored-by: spiess-demos <40452344+spiess-demos@users.noreply.github.com>
Co-authored-by: spiess-demos <40452344+spiess-demos@users.noreply.github.com>
Co-authored-by: spiess-demos <40452344+spiess-demos@users.noreply.github.com>
Co-authored-by: spiess-demos <40452344+spiess-demos@users.noreply.github.com>
@@ -6,6 +6,10 @@ Since v0.0.10, this Changelog is formatted according to the [Common Changelog][c

### Added

- ([#344](https://github.com/demos-europe/demosplan-ui/pull/344)) docs: add documentation for DpTabs ([@@ahmad-demos](https://github.com/@ahmad-demos))

### Added
Copy link
Contributor

Choose a reason for hiding this comment

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

An "Added" section already exists!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done in 6fb4106

- props not showing up as expected, because Storybook docs integration is broken.
CHANGELOG.md Outdated Show resolved Hide resolved
Co-authored-by: spiess-demos <40452344+spiess-demos@users.noreply.github.com>
Copy link
Contributor

@spiess-demos spiess-demos left a comment

Choose a reason for hiding this comment

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

lgtm!

@ahmad-demos ahmad-demos merged commit cbfde6e into main Jul 4, 2023
@ahmad-demos ahmad-demos deleted the f_T33323_add_storybook_to_DpTabs branch July 4, 2023 09:19
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
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants