New user feedback

doc/explanation/api/examples/outliers_declarative.md

@@ -82,3 +82,40 @@ pn.Column(obj.param, obj.view)
 ```
 
 To support various domains, you can create hierarchies of classes encapsulating parameters and functionality across different object families. Parameters and code can inherit across classes as needed, without depending on any specific GUI library. This approach facilitates the maintenance of large codebases, all displayable and editable with Panel, adaptable over time. For a more complex illustration, refer to the [Attractors Panel app](https://examples.holoviz.org/gallery/attractors/attractors_panel.html) ([source](https://github.com/holoviz-topics/examples/tree/main/attractors)), and explore the Panel codebase itself for extensive usage of Param throughout the codebase.
+
+## Serving the Notebook
+
+Lets finalize our app by organizing our components in a nicely styled template (`MaterialTemplate`) and mark it `.servable()` to add it to our served app:
+
+```python
+pn.template.MaterialTemplate(
+    site="Panel",
+    title="Getting Started App",
+    sidebar=[obj.param],
+    main=[obj.view],
+).servable(); # The ; is needed in the notebook to not display the template. Its not needed in a script
+```
+
+Save the notebook with the name `app.ipynb`.
+
+Finally, we'll serve the app by running the command below in a terminal:
+
+```bash
+panel serve app.ipynb --autoreload
+```
+
+Now, open the app in your browser at [http://localhost:5006/app](http://localhost:5006/app).
+
+It should look like this:
+
+![Getting Started App](../../../_static/images/getting_started_app.png)
+
+:::{tip}
+
+If you prefer developing in a Python Script using an editor, you can copy the code into a file `app.py` and serve it.
+
+```bash
+panel serve app.py --autoreload
+```
+
+:::

doc/getting_started/build_app.md

@@ -14,7 +14,7 @@ If you're eager to roll up your sleeves and build this app alongside us, we reco
 Initially, the code block outputs on this website offer limited interactivity, indicated by the <font color="darkgoldenrod">golden</font> border to the left of the output below. By clicking the play button (<svg class="pyodide-run-icon" style="width:32px;height:25px" viewBox="0 0 24 24"> <path stroke="none" fill="#28a745" d="M8,5.14V19.14L19,12.14L8,5.14Z"></path> </svg>), you can activate full interactivity, marked by a <font color="green">green</font> left-border.
 :::
 
-## Fetching the Data
+## Configuring the Application
 
 First, let's import the necessary dependencies and define some variables:
 
@@ -37,6 +37,8 @@ Next, we'll import the Panel JavaScript dependencies using `pn.extension(...)`.
 pn.extension(design="material", sizing_mode="stretch_width")
 ```
 
+## Fetching the Data
+
 Now, let's load the [UCI ML dataset](http://archive.ics.uci.edu/dataset/357/occupancy+detection) that measured the environment in a meeting room. We'll speed up our application by caching (`@pn.cache`) the data across users:
 
 ```{pyodide}
@@ -121,7 +123,7 @@ pn.template.MaterialTemplate(
 
 Save the notebook with the name `app.ipynb`.
 
-Finally, we'll serve the app with:
+Finally, we'll serve the app by running the command below in a terminal:
 
 ```bash
 panel serve app.ipynb --autoreload

doc/getting_started/installation.md

@@ -78,6 +78,38 @@ Make sure Panel is installed in the same environment as JupyterLab/Jupyter Noteb
 If you plan to use Panel in a non-Jupyter notebook environment, such as Google Colab or VSCode, refer to the [relevant how-to section](../how_to/notebook/other_nb.md).
 :::
 
+## Updating Panel
+
+:::{important}
+
+Instead of updating, we recommend that you create a new virtual environment from scratch and reinstall Panel to minimize the risk of potential issues.
+
+:::
+
+We suggest updating the dependencies `param` and `bokeh` along with `panel` and `watchfiles` to reduce the likelihood of problems.
+
+:::::{tab-set}
+
+::::{tab-item} pip
+:sync: pip
+
+```bash
+pip install --upgrade panel watchfiles param bokeh
+```
+
+::::
+
+::::{tab-item} conda
+:sync: conda
+
+```bash
+conda update panel watchfiles param bokeh
+```
+
+::::
+
+:::::
+
 ## Next Steps
 
 Now that you have installed Panel, let's [build a simple application](build_app.md).