docs(manifest): Improvements to scope page

[dipikabh]

Description

This PR is part of improving the web/manifest docs:

• Adds "Syntax", "Values", and "Description"
• Covers notes and examples from the spec
• Adds prose to the examples

Motivation

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

Additional details

Spec links:

• https://w3c.github.io/manifest/#scope-member
• https://w3c.github.io/manifest/#nav-scope

Related issues and pull requests

Tracking issue: mdn/mdn#560

Also:
Fixes #32948

[github-actions]

Preview URLs

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

(comment last updated: 2024-10-29 22:19:01)

[dipikabh]

Thanks for the review, Hamish.

[dipikabh]

Hi Hamish, thanks a lot for the review!

I've done a couple of things in this iteration:

• Clarified in the intro and in other sections that the behavior is applicable and visible with the installed app (not when using the app in a browser).
• Moved "In-scope and out-of-scope behavior" to make it the first subsection in "Description" since it explains the core functionality.
  • I've added a web app example and screenshots that hopefully better illustrate the in-scope and out-of-scope behaviors.
• Added a separate subsection for "Scope's affect on deep-linked pages" and reworded prose to improve clarity

I'm hoping these updates will address your comments. Let me know what you think.

[hamishwillee]

Changes look really good. I've added some very minor suggestions.

[dipikabh]

Thanks, I've incorporated your suggestions.

[hamishwillee]

Thanks very much! Looking good.