From e4623d7d116f9ad5273f94b0bc88e65cab915392 Mon Sep 17 00:00:00 2001
From: John Tourtellott <john.tourtellott@kitware.com>
Date: Wed, 13 Mar 2024 14:36:57 -0400
Subject: [PATCH 1/2] Update docs with some notes for Windows Subsystem for
 Linux (WSL) use case

---
 docs/sphinx/install.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/sphinx/install.rst b/docs/sphinx/install.rst
index 266df6c..031d02d 100644
--- a/docs/sphinx/install.rst
+++ b/docs/sphinx/install.rst
@@ -16,6 +16,14 @@ If you don't have a container engine installed on your system, you will need to
 
 On most Linux machines, the package manager includes the Docker container engine and command line interface (CLI) as standard packages. If available, this is the easiest way to install a container engine on your system.
 
+Note that, in order to use docker, you must add yourself to the "docker" group on your machine. (And create a docker group if it is not already on your system.)
+
+.. admonition:: Window Subsystem for Linux (WSL)
+
+  If you are using Windows Subsystem for Linux (WSL):
+    - The `Microsoft directions <https://learn.microsoft.com/en-us/windows/wsl/tutorials/wsl-containers>`_ only describe installing Docker Desktop for Windows, and make no mention of installing the native linux container engine. Anecdotally, we have been told that the native container engine is problematic in WSL. To avoid a Docker Desktop subscription, you can try installing podman in WSL.
+    - Also be sure to install the virtual GPU driver for your hardware. The download links are at https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps
+
 1.2 Docker Desktop
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -34,6 +42,9 @@ Note that, after installing :program:`Podman`, you must set the podman machine "
     > podman machine set --rootful
     > podman machine start
 
+.. warning::
+  To use OpenFOAM with modelbuilder, be sure to **run modelbuilder as a non-root user** on your system. The OpenFOAM image uses different environments for root and non-root users, and does not run the OpenFOAM executables for root users.
+
 
 2\. Download modelbuilder Package
 -----------------------------------
-- 
GitLab


From 38c0f1f4b3d5c81aa98d104756966e69ca31e50c Mon Sep 17 00:00:00 2001
From: John Tourtellott <john.tourtellott@kitware.com>
Date: Wed, 13 Mar 2024 14:47:48 -0400
Subject: [PATCH 2/2] Update .readthedocs.yaml to changes in file format

---
 .readthedocs.yaml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index 9ea89cc..1722a9e 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -2,14 +2,19 @@
 
 version: 2
 
+build:
+  os: ubuntu-20.04
+  tools:
+    python: "3.9"
+
 sphinx:
+  builder: html
   configuration: docs/sphinx/conf.py
 
 formats:
   - htmlzip
 
 python:
-  version: "3"
   install:
     - requirements: docs/sphinx/requirements.txt
 
-- 
GitLab