Clean up Shiny docs (R and Python)

[cwickham]

Shiny for Python docs currently live under Guide > Dashboards > Interactivity > Shiny for Python

Shiny for R docs mostly live under Guide > Interactivity > Shiny (i.e. not under Dashboards, although some pages are included in both locations Guide > Dashboards, and Guide > Interactivity).

This currently leads to confusion:

• Navigating to Guide > Interactivity > Shiny > Running Documents, drops you into the Dashboard docs
• Shiny for Python isn't mentioned in Guide > Interactivity

Some questions to consider:

• How do "Guide > Interactivity" and "Guide > Dashboards > Interactivity" differ? Do we need both? What content can be shared? How should they be linked? What distinctions do we want to outline for users?

• Do we still need Component Layout https://quarto.org/docs/interactive/layout.html ? I think this page should focus on the layout of components in longer form articles, and link to dashboards for full page layouts.

• Where do we talk about the difference between a Quarto dashboard with Shiny Python, and a Shiny Python app (ditto for R): no server() function, no ui layout functions e.g. ui.page_fluid() etc, no call to App(), no @output decorator (python), adding #| context: server (R)? Some mentions in various places, but it would be nice to have some side by side comparisons of code.

[cwickham]

Guide > Interactivity: Fuller, more complete Shiny documentation.

• Overview needs to mention Shiny for Python
• Should have parallel docs for Shiny for R and Shiny for Python.
  • Introduction
  • Running Documents
  • Execution Contexts
  • External Resources
  • Examples
• Add a page on the difference between writing a Shiny app in a script file and in a Quarto document.
• Re-write https://quarto.org/docs/interactive/layout.html to focus more on layout of apps in long form article content. Link to Dashboards as the layout option for full page apps.

Guide > Dashboards > Interactivity: Enough to see what Shiny can do, and get started in the Dashboard Context. Assume some python readers will have never heard of Shiny.

• Getting Started: A complete shiny dashboard example (like existing Shiny for Python docs).
• Abbreviated/targeted content on running documents and execution contexts, then link out to Guide > Interactivity.

[cwickham]

Example of how we aren't serving people new to shiny: #8608

[cwickham]

Related issue: #4497