Skip to content

[Docs] Add Layer content update#5843

Open
Sulaymon333 wants to merge 2 commits intomasterfrom
wip-layer-content-update
Open

[Docs] Add Layer content update#5843
Sulaymon333 wants to merge 2 commits intomasterfrom
wip-layer-content-update

Conversation

@Sulaymon333
Copy link
Collaborator

Deploy Preview

What does this PR do?

  • Add new use cases section and placeholder text
  • [Note] this should be updated when all sub tasks are completed.

What are the relevant issues?

Where should the reviewer start?

How should this be manually tested?

Any background context you want to provide?

Screenshots (if appropriate)

Should this PR be mentioned in Design System updates?

Is this change backwards compatible or is it a breaking change?

Copilot AI review requested due to automatic review settings February 23, 2026 11:59
@changeset-bot
Copy link

changeset-bot bot commented Feb 23, 2026

⚠️ No Changeset found

Latest commit: d83393c

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@netlify
Copy link

netlify bot commented Feb 23, 2026

Deploy Preview for hpe-design-icons-grommet ready!

Name Link
🔨 Latest commit d83393c
🔍 Latest deploy log https://app.netlify.com/projects/hpe-design-icons-grommet/deploys/699f352199077d0008fa2ac6
😎 Deploy Preview https://deploy-preview-5843--hpe-design-icons-grommet.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link

netlify bot commented Feb 23, 2026

Deploy Preview for unrivaled-bublanina-3a9bae ready!

Name Link
🔨 Latest commit d83393c
🔍 Latest deploy log https://app.netlify.com/projects/unrivaled-bublanina-3a9bae/deploys/699f352178ca4100084c36dc
😎 Deploy Preview https://deploy-preview-5843--unrivaled-bublanina-3a9bae.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link

netlify bot commented Feb 23, 2026

Deploy Preview for hpe-theme-preview ready!

Name Link
🔨 Latest commit d83393c
🔍 Latest deploy log https://app.netlify.com/projects/hpe-theme-preview/deploys/699f35213a840e0007ee3e04
😎 Deploy Preview https://deploy-preview-5843--hpe-theme-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the Layer component documentation page by introducing a new “Use cases” section near the top of the page.

Changes:

  • Reformatted the layouts import block for readability/formatting consistency.
  • Replaced the previous “When to use” content with a new “Use cases” section containing multiple new subsections (currently placeholder text).
  • Minor formatting tweak near the Accessibility section (quote style + spacing).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +37 to +45
## Use cases

### Confirming next steps

[Placeholder for confirming next steps example]

### Confirming destructive deletion

[Placeholder for confirming destructive deletion example]
Copy link

Copilot AI Feb 23, 2026

Choose a reason for hiding this comment

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

The new "Use cases" section currently renders multiple bracketed placeholder lines (e.g. "[Placeholder for …]") and also removes the prior introductory guidance about when Layers should be used. This will ship unfinished content to the docs; either replace these placeholders with real guidance/examples, or hide them (e.g. MDX comments) and keep a short introductory paragraph explaining intended usage until examples are ready.

Copilot uses AI. Check for mistakes.

[Placeholder for filtering data example]

### Completing a multi‑step process
Copy link

Copilot AI Feb 23, 2026

Choose a reason for hiding this comment

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

The heading "Completing a multi‑step process" uses a non-standard hyphen character (U+2011), while the placeholder text below uses a regular hyphen ("multi-step"). Consider using a regular '-' in the heading as well to avoid odd anchor/slug generation and keep wording consistent.

Suggested change
### Completing a multistep process
### Completing a multi-step process

Copilot uses AI. Check for mistakes.

### Announcing layer open and close

It is critical that users of assisstive technologies are informed when a layer opens and closes. The approach to implementation differs. depending on if a layer is [modal](#modal-layers) or [non-modal](#non-modal-layers).
Copy link

Copilot AI Feb 23, 2026

Choose a reason for hiding this comment

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

Typo: "assisstive" should be "assistive".

Copilot uses AI. Check for mistakes.
The following should cause an actionable layer to close:

1. Clicking the [close icon](/foundation/icons#ui-actions) button in the layer's header.
- Note: Actionable center layers should not include a close button in the layer's header. Center layers generally present confirmations, therefor the user should intentionally choose between accepting or cancelling the layer's action prompt.
Copy link

Copilot AI Feb 23, 2026

Choose a reason for hiding this comment

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

Typo: "therefor" should be "therefore".

Copilot uses AI. Check for mistakes.

### Announcing layer open and close

It is critical that users of assisstive technologies are informed when a layer opens and closes. The approach to implementation differs. depending on if a layer is [modal](#modal-layers) or [non-modal](#non-modal-layers).
Copy link

Copilot AI Feb 23, 2026

Choose a reason for hiding this comment

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

Grammar/punctuation: "The approach to implementation differs. depending on if…" should be a single sentence (e.g., "differs depending on whether…").

Copilot uses AI. Check for mistakes.
@Sulaymon333 Sulaymon333 changed the title [Doc] Add Layer content update [Docs] Add Layer content update Feb 23, 2026
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.

2 participants