Add @app to the Page Guide · h2oai/wave#581

(3 comments) (0 reactions) (0 assignees)Python (3,677 stars) (279 forks)batch import

docsgood first issue

Description

Is your feature request related to a problem? Please describe

The @app('/') feature is explained in the API section of the docs (https://wave.h2o.ai/docs/api/server#app), but is only really find-able if someone is looking for it. When users are on the Pages section of the Guide (https://wave.h2o.ai/docs/pages/) it might be nice for them to explicitly learn about @app() as this is a shortcut for sending apps to a specific page.

Describe the solution you'd like

Add a brief sentence and code snippet to the Pages Guide: https://wave.h2o.ai/docs/pages/

Right after the code for To reference the current page in a Wave app, use q.page.. Here is a first-pass suggestion

To reference a specific page in a Wave app, use the `@app(/foo)` decorator

~
@app('/foo')
async def serve(q: Q):
    page = q.page
~

Contributor guide

Tech stack: python
Domain: documentation
Issue type: documentation
Difficulty: 1
Estimated time: under 1 hour
Activity status: stale
Clarity: clear
Prerequisites: PythonWave framework basics
Newbie friendliness: 85
Research direction: Edit the Pages guide at https://wave.h2o.ai/docs/pages/ to add a sentence and code snippet about the @app() decorator after the existing code for referencing the current page. Follow the suggestion in the issue description, which includes a code snippet using @app('/foo'). Ensure the addition is consistent with the existing documentation style.