docs(manifest): Improvements to orientation 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:

• Explains all the orientation values
• Adds a "Description" section to show a visual representation of the orientations and cover all the info from the spec
• Adds prose to the existing example in "Examples" and adds another example with a scenario to explain the concept

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/#orientation-member
• https://w3c.github.io/screen-orientation/#screen-orientation-types

Related issues and pull requests

Tracking issue: mdn/mdn#560

Fixes #34927

[github-actions]

Preview URLs

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

(comment last updated: 2024-10-01 16:20:54)

[chrisdavidmills]

Hi @dipikabh! Thanks for your awesome work on this, such an improvement on the existing manifest pages. I love that you are taking this on.

I have some comments for you — mostly not serious.

[github-actions]

This pull request has merge conflicts that must be resolved before it can be merged.

[dipikabh]

Hi Chris, thanks for the excellent review suggestions and questions. I ended up redoing a lot of content, so it took a bit longer.
I'd appreciate if you can take another look to see if it makes sense now. Thanks!!

[chrisdavidmills]

@dipikabh wonderful work, Dipika. I just noticed a couple more small typos. Approving, so you can merge when you've considered those.

[dipikabh]

Thanks @chrisdavidmills for taking a look at all the updates and going through the page again. Merging this shortly.