-
Notifications
You must be signed in to change notification settings - Fork 39
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
updated header documentation. #1646
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
a lot of this page needs to be rewritten and restructured.
all the "CONNECT Portal" parts can be removed, our header is not applicable there at all. we should focus on what our header actually does.
Updated. Any other suggestions on what can be added/removed? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the page is still missing meaningful documentation about how to actually use the component. i'm referring to things like explaining the props (appLogo
/breadcrumbs
/actions
) and the subcomponents (HeaderLogo
/HeaderButton
)
Added usage section. |
- Help takes you to Bentley Communities for Bentley Cloud and Web Services. | ||
- User profile is a drop down with options for your user profile. | ||
- Logo can be added using the `appLogo` prop and specifying the desired logo under the `<HeaderLogo>` subcomponent. | ||
- Breadcrumbs trail can be implemented using the `breadcrumbs` prop and `<HeaderBreadcrumbs>` subcomponent. Individual buttons can be added within the breadcrumbs trail using the `<HeaderButton>` subcomponent. For a dropdown menu, the `menuItems` prop can be used inside the `<HeaderButton>` for showing items and `onClick()` property for handling actions. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
onClick
may not need to be mentioned as that can likely be figured out since HeaderButton is a Button
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
better yet, remove the last sentence and just link to the HeaderButton section, which describes everything in detail
- Breadcrumbs trail can be implemented using the `breadcrumbs` prop and `<HeaderBreadcrumbs>` subcomponent. Individual buttons can be added within the breadcrumbs trail using the `<HeaderButton>` subcomponent. For a dropdown menu, the `menuItems` prop can be used inside the `<HeaderButton>` for showing items and `onClick()` property for handling actions. | |
- Breadcrumbs trail can be implemented using the `breadcrumbs` prop and `<HeaderBreadcrumbs>` subcomponent. Individual buttons can be added within the breadcrumbs trail using the [`<HeaderButton>` subcomponent](#headerbutton-subcomponent). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done.
- Settings | ||
|
||
### Actions | ||
<LiveExample src='Header.full.tsx'> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Since we are mentioning that <HeaderButton>
can be made a link (above paragraph), would be good to show it in the example too.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added, was not sure about what link to add for href
, so passing empty string. Is that okay?
…n/iTwinUI into siddhant/update_docs_header
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
looks good for the most part, just a couple more minor comments
Co-authored-by: Mayank <[email protected]>
Co-authored-by: Mayank <[email protected]>
Changes
Updated documentation for the Header component.
Testing
Docs