From 3993e46f971bcc8782601a6c7968bfe3c95b9065 Mon Sep 17 00:00:00 2001
From: Eric Neilsen <neilsen@fnal.gov>
Date: Tue, 12 Mar 2024 12:10:23 -0700
Subject: [PATCH] update startup instructions with options for data sources

---
 docs/usage.rst | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/docs/usage.rst b/docs/usage.rst
index 2f5cfdb6..5e78e393 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -4,14 +4,24 @@ Usage
 Running ``scheduler_dashboard``
 -------------------------------
 
-Activate the conda environment and start the app:
-
-::
+Begin by activating the conda environment::
 
     $ conda activate schedview
-    $ scheduler_dashboard
 
-The app will then give you the URL at which you can find the app.
+There are two ways to start the dashboard, depending on what you want to use
+as the source of data.
+One way is for users to enter arbitrary URLs or file paths from which to load
+the data. **This is insecure,** because users can point the dashboard to malicious
+snapshots. It is, however, much more flexible in a secure environment::
+
+    $ scheduler_dashboard --data-from-urls
+
+Alternately, the dashboard can be started with a flag to only allow users to
+load data from a pre-specified directory on the host running the dashboard::
+
+    $ scheduler_dashboard --data_dir /where/the/snapshot/pickles/are
+
+In either case, the app will then give you the URL at which you can find the app.
 
 Running ``prenight``
 --------------------