@@ -1,4 +1,5 @@
 project_env/
+.DS_Store
 
 # Byte-compiled / optimized / DLL files
 __pycache__/
 
@@ -61,7 +61,7 @@ Here are some recommended steps to get started with Sphinx:
         (docs_env) pip install -r requirements.txt
 
 #. Inside your virtual environment, run ``sphinx-quickstart`` to creates a lot of the boilerplate configurations. This will guide you through a set of questions, such as your project details. We recommend creating separate ``source`` and ``build`` directories.
-#. Build the documentation, e.g. with ``make html``.
+#. Build the documentation, e.g. with ``make html`` (from inside the ``docs`` folder).
 #. Open ``docs/build/html/index.html`` in a browser to see your initial documentation!
 
 Editing your documentation
@@ -89,7 +89,7 @@ Adding new pages to your documentation amount to:
 
 #. Creating new RST files.
 #. Including them in your ``index.rst`` file.
-#. Rebuilding the documentation, e.g. with ``make html``.
+#. Rebuilding the documentation, e.g. with ``make html`` (from inside the ``docs`` folder).
 
 You may also need to edit the ``conf.py`` file to use different features.
 Check out our `index.rst <https://raw.githubusercontent.com/ebezzam/python-dev-tips/main/docs/source/index.rst>`__
 
@@ -15,6 +15,7 @@ Contents
 
 .. toctree::
 
+   remote_development
    documentation
    badges
 
 
@@ -0,0 +1,36 @@
+Remote Development
+==================
+
+In machine learning and scientific computing applications, you may find yourself in a situation where you need to develop and deploy code on a remote machine.
+This may limit your ability to visualize results as your interaction with the remote machine is typically limited to the command line.
+One way to get around this is to use a interactive development environment (IDE) that allows you to run code on a remote machine.
+With Visual Studio (VS) Code, you can use the `Remote - SSH <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh>`__ extension to connect to a remote machine and develop code on it.
+
+`This page <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh>`__ gives you pretty much everything you need to setup remote development with VS Code, most notably `connecting to a remote host <https://code.visualstudio.com/docs/remote/ssh#_connect-to-a-remote-host>`__.
+
+
+Using Jupyter notebooks to visualize plots
+------------------------------------------
+
+Running Jupyter notebooks on a remote machine through VS Code allows you to conveniently visualize results.
+
+First, be sure to install the ``ipykernel`` package in your virtual environment (on the remote machine).
+
+.. code-block:: bash
+
+    pip install ipykernel
+
+When opening your notebook, select your virtual environment.
+
+.. image:: ../images/vscode_jupyter_notebook.png
+
+
+Running long scripts
+--------------------
+
+When you close an SSH connection, the process running on the remote machine is killed.
+If you would like to run a long script on a remote machine, there are several command line tools that let you run a script even after logging out:
+
+* `screen <https://linuxize.com/post/how-to-use-linux-screen/>`__ (Linux or `WSL <https://learn.microsoft.com/en-us/windows/wsl/install>`__ for Windows).
+* `tmux <https://www.hamvocke.com/blog/a-quick-and-easy-guide-to-tmux/>`__ (Linux, WSL, and macOS).
+* `nohup <https://www.geeksforgeeks.org/nohup-command-in-linux-with-examples/>`__ (Linux or WSL).
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`project_env/`
	`2`	`+.DS_Store`
`2`	`3`
`3`	`4`	`# Byte-compiled / optimized / DLL files`
`4`	`5`	`__pycache__/`