docs(manifest): Improvements to shortcuts page

[dipikabh]

Description

This work is part of improving the web/manifest docs.

Apart from normalizing the page layout to include "Syntax" and "Values", this PR includes the following changes:

• Organizes the information into a "Description" section and covers all info from the spec
• Replaces the existing example with two examples with prose

Motivation

To ensure all sections have sufficient explanation, all caveats from spec are covered, and the pages follow a similar template

Additional details

Spec links:

• https://w3c.github.io/manifest/#shortcuts-member
• https://w3c.github.io/manifest/#dfn-shortcut-item

Related issues and pull requests

Tracking issue: mdn/mdn#560

[github-actions]

Preview URLs

• /en-US/docs/Web/Manifest/shortcuts

(comment last updated: 2024-10-08 17:51:03)

[hamishwillee]

Looks good! I've added some suggestions.

I would be really great to see some screenshots, in particular if this behaviour is relatively stable and unlikely to change.

[dipikabh]

Thanks for reviewing, Hamish, some really great suggestions. I've made the updates and left comments if changes are slightly different from the suggestions. This is ready for another look.

(I've added the screenshot idea to my list for doing something similar for icons and display pages.)

[hamishwillee]

Looks great. I merged a couple of minor "clear fixes". This one is for discussion https://github.com/mdn/content/pull/36034/files#r1791057357 - but I have approved so you can merge after looking at it.

[dipikabh]

Thanks, @hamishwillee, for helping get this across the finish line 🙌