Add links to Compiler Explorer

.github/workflows/deploy_docs.yml

@@ -14,6 +14,11 @@ jobs:
 
     steps:
       - uses: actions/checkout@v3
+      - name: Checkout kokkos
+        uses: actions/checkout@v3
+        with:
+          repository: kokkos/kokkos
+          path: kokkos
       - name: Set up Python ${{ env.python-version }}
         uses: actions/setup-python@v4
         with:

docs/source/API/core/parallel-dispatch/parallel_for.rst

@@ -81,6 +81,15 @@ More Detailed Examples are provided in the ExecutionPolicy documentation.
         Kokkos::finalize();
     }
 
+.. raw:: html
+
+   <a href="https://godbolt.org/z/q9h339vob" target="_blank">Edit on Compiler Explorer</a>
+
+.. ceinclude::  ../../../../../kokkos/example/tutorial/01_hello_world_lambda/hello_world_lambda.cpp
+  :language: cpp
+  :start-after: Kokkos::initialize
+  :end-before: Kokkos::finalize
+
 * ``TeamPolicy`` policy with C++ struct as  functor.  Note that the KOKKOS_INLINE_FUNCTION macro adds all of the function specifiers necessary for the target execution space.  The TagA/B structs also provide the ability to 'overload' the operators within the same functor.  Much like the lambda example, the functor and any member variables contained within are captured by value, which means they must have either implicit or explicit copy constructors.
 
 .. code-block:: cpp

docs/source/ceinclude.py

@@ -0,0 +1,20 @@
+from docutils import nodes
+from sphinx.directives.code import LiteralInclude, container_wrapper
+
+class CeIncludeDirective(LiteralInclude):
+    """ LiteralInclude with a Compiler Explorer link"""
+
+    def run(self):
+        retnode = super().run()[0]
+        # paragraph_node = nodes.paragraph(text='Hello World!')
+        retnode = container_wrapper(self, retnode, "https://godbolt.org/z/q9h339vob")
+        return [retnode]
+
+def setup(app):
+    app.add_directive("ceinclude", CeIncludeDirective)
+
+    return {
+        'version': '0.1',
+        'parallel_read_safe': True,
+        'parallel_write_safe': True,
+    }

docs/source/conf.py

@@ -38,7 +38,8 @@
               "sphinx.ext.viewcode",
               "sphinx.ext.intersphinx",
               "sphinx_copybutton",
-              "cppkokkos"]
+              "cppkokkos",
+              "ceinclude"]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']