Add documentation for podman with VS Code

Signed-off-by: William Entriken <[email protected]>

docs/source/Tutorials.rst

@@ -5,6 +5,7 @@ Tutorials
 Here are a number of useful tutorials to get you up and running with Podman. If you are familiar with the Docker `Container Engine`_ the command in Podman_ should be quite familiar. If you are brand new to containers, take a look at our `Introduction`.
 
 * `Basic Setup and Use of Podman <https://github.com/containers/podman/blob/main/docs/tutorials/podman_tutorial.md>`_: Learn how to set up Podman and perform some basic commands with the utility.
+* `Podman in VS Code <https://github.com/containers/podman/blob/main/docs/tutorials/vs_code.md>`_: Set up your project to run Podman inside VS Code.
 * `Basic Setup and Use of Podman in a Rootless environment <https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md>`_: The steps required to set up rootless Podman are enumerated.
 * `Podman for Windows <https://github.com/containers/podman/blob/main/docs/tutorials/podman-for-windows.md>`_: A guide to installing and using Podman on Windows.
 * `Podman Remote Clients on Mac/Windows <https://github.com/containers/podman/blob/main/docs/tutorials/mac_win_client.md>`_: Advanced setup for connecting to a remote Linux system using the Podman remote client on Mac and Windows.

docs/tutorials/README.md

@@ -8,6 +8,10 @@
 
 Learn how to set up Podman and perform some basic commands with the utility.
 
+**[Podman in VS Code](vs_code.md)**
+
+Set up your project to run Podman inside VS Code.
+
 **[Basic Setup and Use of Podman in a Rootless environment](rootless_tutorial.md)**
 
 The steps required to set up rootless Podman are enumerated.

docs/tutorials/vs_code.md

@@ -0,0 +1,26 @@
+![PODMAN logo](../../logo/podman-logo-source.svg)
+
+# Podman in VS Code
+This tutorial shows you how to set up **development containers** inside VS Code to achieve reproducible builds. In this example we will use a ``devcontainer.json` file that also makes your project compatible with GitHub Codespaces and GitHub Actions, however, these instructions can also work for other project hosting and continuous integration services.
+
+In this example we will be using the common scenario of with GitHub Pages to host your blog using Jekyll.
+
+## Installing Podman and VS Code
+
+For installing or building Podman, please see the [installation instructions](https://podman.io/getting-started/installation).
+
+## THINGS TO ADD TO THIS DOCUMENT
+
+- Set up a SIMPLE Jekyll blog in a new directory (without install the Jekyll command locally!)
+- Add dev container file
+- Add Containers extension to VS Code
+- Run the container to host the blog locally
+- Open the blog in the browser
+- Further reading: making this work with GitHub Codespaces and GitHub Actions
+
+../../test/README.md)
+
+## More information
+
+For more information on Podman and its subcommands, checkout the asciiart demos on the [README.md](../../README.md#commands)
+page.