added section on user directory

book/guides/faq.md

@@ -21,3 +21,17 @@ If you **are** member of one of the github teams, ask them to try the following
 - \[ \] Try a different browser
 - \[ \] Restart the computer
 - If these steps do not work, please reach out to the [](support.data_compute_team).
+
+(faq.usr_dir_usage_warning)=
+
+## I received a warning about space on my User Directory
+
+If you get a Hub Usage Alert email, this means you are violating the User Directory storage limit (to learn why this limit exists, see read about [User Directories](hub.guide.data.user_dir)). Remember that user directories are for scripts and notebooks not datasets! Users who persistently violate hub usage policies may temporarily get reduced cloud access.
+
+**Troubleshooting**
+
+- To see which files and directories are taking up the bulk of your storage, run `du -h --max-depth=1 ~/ | sort -h` in Terminal. It will likely reveal cached files and small/medium size data files that can be removed without disrupting typical usage.
+- Delete cached files, ipython checkpoints, and any other unwanted files.
+- If you still require more storage, it is likely that you are storing downloaded data in your user directory. We recommend storing data in a LEAP [cloud bucket](https://leap-stc.github.io/leap-pangeo/jupyterhub.html#leap-pangeo-cloud-storage-buckets) or data catalog. For more information, please consult our [Hub Data Guide](guide.hub.data) and [Data Policy](./../policies/data_policy).
+
+Our goal is to accomodate all community members and thus we are happy to assist users in relocating data. If you have any concerns, please reach out to the [](support.data_compute_team).

book/leap-pangeo/jupyterhub.md

@@ -97,11 +97,11 @@ As shown in the picture above, every user will see `'/home/jovyan'` as their roo
 The primary purpose of this directory is to store small files, like github repositories and other code.
 
 :::\{warning}
-Please do not store large files in your user directory `/home/jovyan`. Your home directory is intended only for notebooks, analysis scripts, and small datasets (\< 1 GB). It is not an appropriate place to store large datasets.
+To accommodate the expanding LEAP community, the data and compute team has instituted a storage quota on individual user directories `/home/jovyan`. Your home directory is intended only for notebooks, analysis scripts, and small datasets (\< 1 GB). It is not an appropriate place to store large datasets. Unlike the cloud buckets, these directories use an underlying storage with a rigid limit. If a single user fills up the space, the Hub crashes for everyone. We recommend users use less than 25GB and enforce a hard limit of 50GB. **Users who persistently violate the limit may temporarily get reduced cloud access**.
 
 To check how much space you are using in your home directory open a terminal window on the hub and run `du -h --max-depth=1 ~/ | sort -h`.
 
-If you want to save larger files for your work use our [](hub.data.buckets) and consult out [Hub Data Guide](guide.hub.data)
+If you want to save larger files for your work use our [](hub.data.buckets) and consult our [Hub Data Guide](guide.hub.data). See the [FAQs](faq.usr_dir_usage_warning) for guidance on reducing storage.
 :::
 
 (hub.data.buckets)=