docs(manifest): Improve display member page

[dipikabh]

Description

This work is part of improving the web/manifest docs. This PR focuses on the display member page.

A few notable changes done in this PR:

• Formatting/layout changes:

  • Removed the "Type" table from the top of the page. The type can be covered in the Syntax section and does not need a table. (On some other pages like file_handlers, this Type table overcrowds with technology status banners.)
  • Created a "Syntax" section with a "Values" subsection. Removed the table describing the values, instead added a definition list format for explaining the values.
  • Created a "Description" section to include additional info about the member instead of using "Notes".

• Content improvements:

  • For each value, added an example scenario where the value might be used
  • Removed the two notes at the top of the page and moved them into the "Values" and "Description" sections, respectively.
  • Added two missing caveats from the spec:
    • One about fullscreen vs Fullscreen API
    • The other about display-mode media feature vs display manifest member
  • Added a more complete example to show the display member in context with other members of the manifest file.

Motivation

To add more usage examples, update information from spec, make the page compliant with our page templates

Additional details

• https://w3c.github.io/manifest/#display-member
• https://w3c.github.io/manifest/#display-modes

Related issues and pull requests

mdn/mdn#560

[github-actions]

Preview URLs

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

(comment last updated: 2024-07-09 12:22:51)

[pepelsbey]

Looks good! Thank you :)

[dipikabh]

Thanks a lot for the review, @pepelsbey.