From 775d554a80e521d3057cd1fa11548e5e7dacd84f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1ty=C3=A1s=20Aradi?= <matyas@streamhpc.com>
Date: Wed, 27 Nov 2024 16:54:59 +0100
Subject: [PATCH] WIP

---
 .../hip_runtime_api/asynchronous/async.svg    | 378 +++++++++++++++
 .../hip_runtime_api/asynchronous/event.svg    | 457 ++++++++++++++++++
 .../asynchronous/sequential.svg               | 313 ++++++++++++
 docs/how-to/hip_runtime_api/asynchronous.rst  |  13 +
 4 files changed, 1161 insertions(+)
 create mode 100644 docs/data/how-to/hip_runtime_api/asynchronous/async.svg
 create mode 100644 docs/data/how-to/hip_runtime_api/asynchronous/event.svg
 create mode 100644 docs/data/how-to/hip_runtime_api/asynchronous/sequential.svg

diff --git a/docs/data/how-to/hip_runtime_api/asynchronous/async.svg b/docs/data/how-to/hip_runtime_api/asynchronous/async.svg
new file mode 100644
index 0000000000..78cc8dac22
--- /dev/null
+++ b/docs/data/how-to/hip_runtime_api/asynchronous/async.svg
@@ -0,0 +1,378 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   version="1.1"
+   width="681px"
+   height="381px"
+   viewBox="-0.5 -0.5 681 381"
+   content="&lt;mxfile&gt;&lt;diagram id=&quot;zBbb_w2fufU70cdOGtND&quot; name=&quot;1 oldal&quot;&gt;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&lt;/diagram&gt;&lt;/mxfile&gt;"
+   id="svg334"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:xhtml="http://www.w3.org/1999/xhtml">
+  <defs
+     id="defs218">
+    <marker
+       style="overflow:visible"
+       id="RoundedArrow"
+       refX="0"
+       refY="0"
+       orient="auto-start-reverse"
+       markerWidth="6.1347523"
+       markerHeight="5.9304953"
+       viewBox="0 0 6.1347524 5.9304951"
+       preserveAspectRatio="xMidYMid">
+      <path
+         transform="scale(0.7)"
+         d="m -0.21114562,-4.1055728 6.42229122,3.21114561 a 1,1 90 0 1 0,1.78885438 L -0.21114562,4.1055728 A 1.236068,1.236068 31.717474 0 1 -2,3 v -6 a 1.236068,1.236068 148.28253 0 1 1.78885438,-1.1055728 z"
+         style="fill:context-stroke;fill-rule:evenodd;stroke:none"
+         id="path1367" />
+    </marker>
+  </defs>
+  <g
+     id="g324">
+    <rect
+       x="0"
+       y="0"
+       width="680"
+       height="380"
+       fill="#5e5b61"
+       stroke="none"
+       pointer-events="all"
+       id="rect220" />
+    <rect
+       x="9.5"
+       y="239.5"
+       width="660"
+       height="65"
+       fill="#333333"
+       stroke="none"
+       pointer-events="none"
+       id="rect258"
+       style="stroke-width:0.718068" />
+    <rect
+       x="206.5"
+       y="249.50002"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(-58.47918,-8.7840181)"
+       id="g266">
+      <switch
+         id="switch264-9"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1"><tspan
+             id="tspan13108"
+             x="430"
+             y="328">H2D</tspan><tspan
+             id="tspan13110"
+             x="430"
+             y="349.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="405"
+       y="249.50002"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-8"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(140.02082,2.2159781)"
+       id="g266-8">
+      <switch
+         id="switch264-9-1"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="317"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-1"><tspan
+             id="tspan13116"
+             x="430"
+             y="317">D2H</tspan><tspan
+             id="tspan13118"
+             x="430"
+             y="338.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="305.4169"
+       y="249.9169"
+       width="99.166214"
+       height="44.16621"
+       fill="#c23555"
+       stroke="#a20025"
+       pointer-events="none"
+       id="rect268"
+       style="stroke-width:0.83379" />
+    <g
+       transform="translate(-236,-61.331053)"
+       id="g274">
+      <switch
+         id="switch272">
+        <text
+           x="589"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text270"><tspan
+             id="tspan13112"
+             x="589"
+             y="328">kernel</tspan><tspan
+             id="tspan13114"
+             x="589"
+             y="349.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="9.5"
+       y="159.5"
+       width="660"
+       height="65"
+       fill="#333333"
+       stroke="none"
+       pointer-events="none"
+       id="rect258-1"
+       style="stroke-width:0.718068" />
+    <rect
+       x="9.5"
+       y="49.5"
+       width="660"
+       height="65"
+       fill="#333333"
+       stroke="none"
+       pointer-events="none"
+       id="rect258-1-4"
+       style="stroke-width:0.718068" />
+    <rect
+       x="160.5"
+       y="169.5"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-9"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(-104.47918,-88.784016)"
+       id="g266-4">
+      <switch
+         id="switch264-9-3"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6"><tspan
+             id="tspan13096"
+             x="430"
+             y="328">H2D</tspan><tspan
+             id="tspan13098"
+             x="430"
+             y="349.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,-77.78402)"
+       id="g266-4-9">
+      <switch
+         id="switch264-9-3-6"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8"
+           style="text-align:start;text-anchor:start">stream1</text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,-187.62631)"
+       id="g266-4-9-4">
+      <switch
+         id="switch264-9-3-6-4"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-8"
+           style="text-align:start;text-anchor:start;white-space:pre;inline-size:132.394;display:inline"
+           xml:space="preserve"><tspan
+             x="430"
+             y="328"
+             id="tspan23481">default stream</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,2.21598)"
+       id="g266-4-9-7">
+      <switch
+         id="switch264-9-3-6-0"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-6"
+           style="text-align:start;text-anchor:start"><tspan
+             id="tspan7816"
+             x="430"
+             y="328">stream2</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,76.166175)"
+       id="g266-4-9-7-4">
+      <switch
+         id="switch264-9-3-6-0-2"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-6-1"
+           style="text-align:start;text-anchor:start"><tspan
+             id="tspan7816-2"
+             x="430"
+             y="328">time</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="305.5"
+       y="169.5"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-8-8"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(40.52082,-77.784022)"
+       id="g266-8-2">
+      <switch
+         id="switch264-9-1-6"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="317"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-1-1"><tspan
+             id="tspan13104"
+             x="430"
+             y="317">D2H</tspan><tspan
+             id="tspan13106"
+             x="430"
+             y="338.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="205.9169"
+       y="169.9169"
+       width="99.166214"
+       height="44.16621"
+       fill="#c23555"
+       stroke="#a20025"
+       pointer-events="none"
+       id="rect268-2"
+       style="stroke-width:0.83379" />
+    <g
+       transform="translate(-335.5,-141.33105)"
+       id="g274-1">
+      <switch
+         id="switch272-7">
+        <text
+           x="589"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text270-2"><tspan
+             id="tspan13100"
+             x="589"
+             y="328">kernel</tspan><tspan
+             id="tspan13102"
+             x="589"
+             y="349.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#ffffff;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#RoundedArrow)"
+       d="M 63.5,345.4305 H 654.05363"
+       id="path7857" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#808080;stroke-width:0.999997px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 206.06097,304.5 v -145"
+       id="path10589" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#808080;stroke-width:0.999997px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 305.17322,304.5 v -145"
+       id="path10589-5" />
+  </g>
+  <switch
+     id="switch332">
+    <g
+       requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"
+       id="g326" />
+    <a
+       transform="translate(0,-5)"
+       xlink:href="https://www.diagrams.net/doc/faq/svg-export-text-problems"
+       target="_blank"
+       id="a330">
+      <text
+         text-anchor="middle"
+         font-size="10px"
+         x="50%"
+         y="100%"
+         id="text328">Text is not SVG - cannot display</text>
+    </a>
+  </switch>
+</svg>
diff --git a/docs/data/how-to/hip_runtime_api/asynchronous/event.svg b/docs/data/how-to/hip_runtime_api/asynchronous/event.svg
new file mode 100644
index 0000000000..7ecfb123ad
--- /dev/null
+++ b/docs/data/how-to/hip_runtime_api/asynchronous/event.svg
@@ -0,0 +1,457 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   version="1.1"
+   width="681px"
+   height="381px"
+   viewBox="-0.5 -0.5 681 381"
+   content="&lt;mxfile&gt;&lt;diagram id=&quot;zBbb_w2fufU70cdOGtND&quot; name=&quot;1 oldal&quot;&gt;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&lt;/diagram&gt;&lt;/mxfile&gt;"
+   id="svg334"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:xhtml="http://www.w3.org/1999/xhtml">
+  <defs
+     id="defs218">
+    <marker
+       style="overflow:visible"
+       id="RoundedArrow"
+       refX="0"
+       refY="0"
+       orient="auto-start-reverse"
+       markerWidth="6.1347523"
+       markerHeight="5.9304953"
+       viewBox="0 0 6.1347524 5.9304951"
+       preserveAspectRatio="xMidYMid">
+      <path
+         transform="scale(0.7)"
+         d="m -0.21114562,-4.1055728 6.42229122,3.21114561 a 1,1 90 0 1 0,1.78885438 L -0.21114562,4.1055728 A 1.236068,1.236068 31.717474 0 1 -2,3 v -6 a 1.236068,1.236068 148.28253 0 1 1.78885438,-1.1055728 z"
+         style="fill:context-stroke;fill-rule:evenodd;stroke:none"
+         id="path1367" />
+    </marker>
+  </defs>
+  <g
+     id="g324">
+    <rect
+       x="0"
+       y="0"
+       width="680"
+       height="380"
+       fill="#5e5b61"
+       stroke="none"
+       pointer-events="all"
+       id="rect220" />
+    <rect
+       x="9.5"
+       y="239.5"
+       width="660"
+       height="65"
+       fill="#333333"
+       stroke="none"
+       pointer-events="none"
+       id="rect258"
+       style="stroke-width:0.718068" />
+    <rect
+       x="206.5"
+       y="249.50002"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(-58.47918,-8.7840181)"
+       id="g266">
+      <switch
+         id="switch264-9"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1"><tspan
+             id="tspan13108"
+             x="430"
+             y="328">H2D</tspan><tspan
+             id="tspan13110"
+             x="430"
+             y="349.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="405"
+       y="249.50002"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-8"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(140.02082,2.2159781)"
+       id="g266-8">
+      <switch
+         id="switch264-9-1"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="317"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-1"><tspan
+             id="tspan13116"
+             x="430"
+             y="317">D2H</tspan><tspan
+             id="tspan13118"
+             x="430"
+             y="338.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="305.4169"
+       y="249.9169"
+       width="99.166214"
+       height="44.16621"
+       fill="#c23555"
+       stroke="#a20025"
+       pointer-events="none"
+       id="rect268"
+       style="stroke-width:0.83379" />
+    <g
+       transform="translate(-236,-61.331053)"
+       id="g274">
+      <switch
+         id="switch272">
+        <text
+           x="589"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text270"><tspan
+             id="tspan13112"
+             x="589"
+             y="328">kernel</tspan><tspan
+             id="tspan13114"
+             x="589"
+             y="349.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="9.5"
+       y="159.5"
+       width="660"
+       height="65"
+       fill="#333333"
+       stroke="none"
+       pointer-events="none"
+       id="rect258-1"
+       style="stroke-width:0.718068" />
+    <rect
+       x="9.5"
+       y="49.5"
+       width="660"
+       height="65"
+       fill="#333333"
+       stroke="none"
+       pointer-events="none"
+       id="rect258-1-4"
+       style="stroke-width:0.718068" />
+    <rect
+       x="160.5"
+       y="169.5"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-9"
+       style="stroke-width:0.243252" />
+    <rect
+       x="156.5"
+       y="59.500004"
+       width="4"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-9-0"
+       style="fill:#ffffff;stroke-width:0.243253" />
+    <g
+       transform="translate(-104.47918,-88.784016)"
+       id="g266-4">
+      <switch
+         id="switch264-9-3"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6"><tspan
+             id="tspan13096"
+             x="430"
+             y="328">H2D</tspan><tspan
+             id="tspan13098"
+             x="430"
+             y="349.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,-77.78402)"
+       id="g266-4-9">
+      <switch
+         id="switch264-9-3-6"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8"
+           style="text-align:start;text-anchor:start">stream1</text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,-187.62631)"
+       id="g266-4-9-4">
+      <switch
+         id="switch264-9-3-6-4"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-8"
+           style="text-align:start;text-anchor:start;white-space:pre;inline-size:132.394;display:inline"
+           xml:space="preserve"><tspan
+             x="430"
+             y="328"
+             id="tspan23168">default stream</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-109.18743,-187.62631)"
+       id="g266-4-9-4-1">
+      <switch
+         id="switch264-9-3-6-4-2"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-8-3"
+           style="text-align:start;text-anchor:start;white-space:pre;inline-size:132.394;display:inline"
+           xml:space="preserve"><tspan
+             x="430"
+             y="328"
+             id="tspan23170">create events</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,2.21598)"
+       id="g266-4-9-7">
+      <switch
+         id="switch264-9-3-6-0"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-6"
+           style="text-align:start;text-anchor:start"><tspan
+             id="tspan7816"
+             x="430"
+             y="328">stream2</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,76.166175)"
+       id="g266-4-9-7-4">
+      <switch
+         id="switch264-9-3-6-0-2"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-6-1"
+           style="text-align:start;text-anchor:start"><tspan
+             id="tspan7816-2"
+             x="430"
+             y="328">time</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="405.5"
+       y="169.5"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-8-8"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(140.52082,-77.784022)"
+       id="g266-8-2">
+      <switch
+         id="switch264-9-1-6"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="317"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-1-1"><tspan
+             id="tspan13104"
+             x="430"
+             y="317">D2H</tspan><tspan
+             id="tspan13106"
+             x="430"
+             y="338.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(17.833566,-110.41946)"
+       id="g266-8-2-7">
+      <switch
+         id="switch264-9-1-6-7"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="317"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-1-1-8"><tspan
+             id="tspan13106-9"
+             x="430"
+             y="317"
+             style="font-size:13.3333px">event1</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(116.86377,-110.41946)"
+       id="g266-8-2-7-9">
+      <switch
+         id="switch264-9-1-6-7-0"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="317"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-1-1-8-4"><tspan
+             id="tspan13106-9-1"
+             x="430"
+             y="317"
+             style="font-size:13.3333px">event2</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="205.9169"
+       y="169.9169"
+       width="99.166214"
+       height="44.16621"
+       fill="#c23555"
+       stroke="#a20025"
+       pointer-events="none"
+       id="rect268-2"
+       style="stroke-width:0.83379" />
+    <g
+       transform="translate(-335.5,-141.33105)"
+       id="g274-1">
+      <switch
+         id="switch272-7">
+        <text
+           x="589"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text270-2"><tspan
+             id="tspan13100"
+             x="589"
+             y="328">kernel</tspan><tspan
+             id="tspan13102"
+             x="589"
+             y="349.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#ffffff;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#RoundedArrow)"
+       d="M 63.5,345.4305 H 654.05363"
+       id="path7857" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#808080;stroke-width:0.999997px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 206.06097,304.5 v -145"
+       id="path10589" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#ff0101;stroke-width:0.999997px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 305.17322,304.5 v -145"
+       id="path10589-5" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#ff0101;stroke-width:0.999997px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 405.09145,304.5 v -145"
+       id="path10589-5-2" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#808080;stroke-width:0.999997px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="M 160.59904,224.50001 V 49.500002"
+       id="path10589-5-6" />
+  </g>
+  <switch
+     id="switch332">
+    <g
+       requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"
+       id="g326" />
+    <a
+       transform="translate(0,-5)"
+       xlink:href="https://www.diagrams.net/doc/faq/svg-export-text-problems"
+       target="_blank"
+       id="a330">
+      <text
+         text-anchor="middle"
+         font-size="10px"
+         x="50%"
+         y="100%"
+         id="text328">Text is not SVG - cannot display</text>
+    </a>
+  </switch>
+</svg>
diff --git a/docs/data/how-to/hip_runtime_api/asynchronous/sequential.svg b/docs/data/how-to/hip_runtime_api/asynchronous/sequential.svg
new file mode 100644
index 0000000000..a6265a9089
--- /dev/null
+++ b/docs/data/how-to/hip_runtime_api/asynchronous/sequential.svg
@@ -0,0 +1,313 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   version="1.1"
+   width="681px"
+   height="381px"
+   viewBox="-0.5 -0.5 681 381"
+   content="&lt;mxfile&gt;&lt;diagram id=&quot;zBbb_w2fufU70cdOGtND&quot; name=&quot;1 oldal&quot;&gt;7Vvfc6M2EP5rMtM+hAEJSfDo2MklM7nWkzRtr2/EVmx6GFyME+f++i4gGQFyjGNwnEt4Max+f7v6VlrJJ7g/W32Jvfn0azTmwQkyx6sTPDhByCKODT+p5FlIkGnmkknsj4WsENz6P7gQymxLf8wXpYxJFAWJPy8LR1EY8lFSknlxHD2Vsz1EQbnVuTcRLZqF4HbkBbyW7S9/nExzKaVK7kvuT6aiZSr7fe+Nvk/iaBmK5sIo5HnKzJO1iKyLqTeOnhQRPj/B/TiKkvxtturzIIVVApaXu9iQuu5xzMOkSQHiIpaXefSCpRi36FryLIHIxsLTIuYJPnua+gm/nXujNPUJdA+yaTIL4MuC1wc/CPpREMVZWUzOyRnN5FGYKPKL7AH5Iomj71ymZFiBEKr3w4losT4qMdBHHid8pYjEKL/waMaT+BmyCOM7xQLxJ0WTjpBNFS1iKfSE9UzWdRU4wouAchOsNukW1j4gS0hjWCGlB9MPkT3RlKkCIwmupQGX6sBtB1uqwZYGiUAjneo5iiD9b5lOpbNLHjzyxB95hQjeJlnS1RBK3CzDxJ/BNDV7wytZG3QlrzDPWVMgoJWUtaQ1ZlV1QuQF/iSEzxHogIP8LMUeuhf0RMLMH4/TZrRmUTactIuCPC32gkW0oHdGtuqd4I70fvd4uRySiP57u4yu/5iZvbt/eqfEJXj7REvJeN58+GuP4t0HqoNoOh2cOipYhwqirUwH1DHV5M+uDF6He5sCt1vhQQDd1E30ajvbdeC72x81KCuZoOWaBtA9c+Xj1EwSudjAuA6i9FxdYGh2a6nU9FwdBT5kj84pogGjpn6Jsc0OdjLXHGyzeOzDAm9pgM993Nh/lP6tfzfoQaZB7MPgap5QyfjTOcL9db32BIZLbWwzBzuMWag0KZlBTPWx6nOSUgPmrIVNBpVgRKjOlxqlWqQp7bmmcrZPTR6Oe+m2KlVX4C0W/ihTtBcnUiyUqthBWUO5VcjNFJLFL/y0Z1kOvvKTv9N3g4ivb6Km9H2wUrINnuVHCMPNC2HiSME3NbUomH2VSg55DCu/zPqUTu5nOIJXF9EyFitRwFhyNAx5wrdUIJiSj+UWdTvHEI1HlLKYB14C07rkZXQWI1oYRn62kF6bdUpfpGZz0tuYjgE+qnhwuYEcBlGnuhutNOOUl5eWTQxarimHrlZTZt9rVBqaPNVtI47Jo6tUQUvIULtOHZZG/W24lMJu34XbVvS6m4e2Krza0dII+qej2k3OOJb70g/hh3dSnkh1Ddt1CSW2ixHD8FLxubarPKw+cSzXAsVT08WUupQ4qK53aMMtPXR/O9hAIbL5t/bDuzhB66h8FWLl3Xh1T9jUGVXrWX+374s2uZN3srHfOYyEyfaACeouYNIE165DRphusC6VmezOXDppsPY5mvC0orGdXDrgdyCXTnQrpJpLv/m9H39Al76D8iT1GjJgIQnCkJFnVb3YBresYQnYZ7ei1AZb4q5pgqC3pQn3fdGEswH3I6EJqot/1mhi2Lv+ONzQXGNyRhhp7N+GxTqyHGRXNsaV5b6kB1XbkAdjhoGzmcsYspiGQTpY74P2Gyztu+YT26yGWIBDNXHIDoMJDc7rjohS1ko71mCC3YRS+tc3H4ZSdtCYPNU2HLuIIFBUDm42oJS3iSDAUBtsZA4StC8C8GSX8PvmIENxDOAgrB4EGKbNXj4MgI9qRH8joaqR+IKaKoGMahg/v37yVuENYrUT3qB2ZWXpdhbeAGQbrCM/o1ovqr0SjbKq6mqq92pFHYa1iMt0585HpXeFumh2TbEgL+B0toXAtOeHDdlGhmCOxMBseXi1r4HZ5GAGtimGfiRW175bbOrI2FGZloVRKy7Lre5dDh6Q3xzme8XFU1l0MffCknHKjMU98tNRbgzZieDk/hcGHYFBmMXvr3mFlSZ6X6E6cwjae4jimbIFyNss9+M+rko+779Wt8+VRZOjOU7URePaufeMtt577sKGfvvzanDV05vRp3W0cA0Y24aJXdSGhbBjD65oIlg1yJviazfFt5XJx3R77Vdz/9SfR8k0vWX5886ld6zrBqejb7xt6SA+Ugt7NNDWgRaQjBjErYdT5Q6jEmx1Xre8tFj5LKG15SV8Fv/oy7MX/5jE5/8D&lt;/diagram&gt;&lt;/mxfile&gt;"
+   id="svg334"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:xhtml="http://www.w3.org/1999/xhtml">
+  <defs
+     id="defs218">
+    <marker
+       style="overflow:visible"
+       id="RoundedArrow"
+       refX="0"
+       refY="0"
+       orient="auto-start-reverse"
+       markerWidth="6.1347523"
+       markerHeight="5.9304953"
+       viewBox="0 0 6.1347524 5.9304951"
+       preserveAspectRatio="xMidYMid">
+      <path
+         transform="scale(0.7)"
+         d="m -0.21114562,-4.1055728 6.42229122,3.21114561 a 1,1 90 0 1 0,1.78885438 L -0.21114562,4.1055728 A 1.236068,1.236068 31.717474 0 1 -2,3 v -6 a 1.236068,1.236068 148.28253 0 1 1.78885438,-1.1055728 z"
+         style="fill:context-stroke;fill-rule:evenodd;stroke:none"
+         id="path1367" />
+    </marker>
+  </defs>
+  <g
+     id="g324">
+    <rect
+       x="0"
+       y="0"
+       width="680"
+       height="380"
+       fill="#5e5b61"
+       stroke="none"
+       pointer-events="all"
+       id="rect220" />
+    <rect
+       x="9.5"
+       y="49.5"
+       width="660"
+       height="65"
+       fill="#333333"
+       stroke="none"
+       pointer-events="none"
+       id="rect258-1-4"
+       style="stroke-width:0.718068" />
+    <rect
+       x="160.5"
+       y="59.5"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-9"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(-104.47918,-198.78402)"
+       id="g266-4">
+      <switch
+         id="switch264-9-3"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6"><tspan
+             id="tspan13096"
+             x="430"
+             y="328">H2D</tspan><tspan
+             id="tspan13098"
+             x="430"
+             y="349.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,-187.62631)"
+       id="g266-4-9-4">
+      <switch
+         id="switch264-9-3-6-4"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-8"
+           style="text-align:start;text-anchor:start;white-space:pre;inline-size:132.394;display:inline"
+           xml:space="preserve"><tspan
+             x="430"
+             y="328"
+             id="tspan23343">default stream</tspan></text>
+      </switch>
+    </g>
+    <g
+       transform="translate(-253.10809,76.166175)"
+       id="g266-4-9-7-4">
+      <switch
+         id="switch264-9-3-6-0-2"
+         transform="translate(-157.91486,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-6-8-6-1"
+           style="text-align:start;text-anchor:start"><tspan
+             id="tspan7816-2"
+             x="430"
+             y="328">time</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="452.125"
+       y="59.5"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-8-8"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(187.14582,-187.78402)"
+       id="g266-8-2">
+      <switch
+         id="switch264-9-1-6"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="317"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-1-1"><tspan
+             id="tspan13104"
+             x="430"
+             y="317">D2H</tspan><tspan
+             id="tspan13106"
+             x="430"
+             y="338.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="252.14917"
+       y="59.916897"
+       width="99.166214"
+       height="44.16621"
+       fill="#c23555"
+       stroke="#a20025"
+       pointer-events="none"
+       id="rect268-2"
+       style="stroke-width:0.83379" />
+    <g
+       transform="translate(-289.26775,-251.33106)"
+       id="g274-1">
+      <switch
+         id="switch272-7">
+        <text
+           x="589"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text270-2"><tspan
+             id="tspan13100"
+             x="589"
+             y="328">kernel</tspan><tspan
+             id="tspan13102"
+             x="589"
+             y="349.25"
+             style="font-size:13.3333px">data1</tspan></text>
+      </switch>
+    </g>
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#ffffff;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#RoundedArrow)"
+       d="M 63.5,345.4305 H 654.05363"
+       id="path7857" />
+    <rect
+       x="206.00209"
+       y="59.5"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(-58.977094,-198.78404)"
+       id="g266">
+      <switch
+         id="switch264-9"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1"><tspan
+             id="tspan13108"
+             x="430"
+             y="328">H2D</tspan><tspan
+             id="tspan13110"
+             x="430"
+             y="349.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="352.34802"
+       y="59.916897"
+       width="99.166214"
+       height="44.16621"
+       fill="#c23555"
+       stroke="#a20025"
+       pointer-events="none"
+       id="rect268"
+       style="stroke-width:0.83379" />
+    <g
+       transform="translate(-189.06888,-251.33107)"
+       id="g274">
+      <switch
+         id="switch272">
+        <text
+           x="589"
+           y="328"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text270"><tspan
+             id="tspan13112"
+             x="589"
+             y="328">kernel</tspan><tspan
+             id="tspan13114"
+             x="589"
+             y="349.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+    <rect
+       x="497.5"
+       y="59.5"
+       width="45"
+       height="45"
+       fill="#4f1623"
+       stroke="none"
+       pointer-events="none"
+       id="rect7153-8"
+       style="stroke-width:0.243252" />
+    <g
+       transform="translate(232.52081,-187.78404)"
+       id="g266-8">
+      <switch
+         id="switch264-9-1"
+         transform="translate(-141.74909,-52.49723)">
+        <text
+           x="430"
+           y="317"
+           fill="#ffffff"
+           font-family="Helvetica"
+           font-size="17px"
+           text-anchor="middle"
+           id="text262-1-1"><tspan
+             id="tspan13116"
+             x="430"
+             y="317">D2H</tspan><tspan
+             id="tspan13118"
+             x="430"
+             y="338.25"
+             style="font-size:13.3333px">data2</tspan></text>
+      </switch>
+    </g>
+  </g>
+  <switch
+     id="switch332">
+    <g
+       requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"
+       id="g326" />
+    <a
+       transform="translate(0,-5)"
+       xlink:href="https://www.diagrams.net/doc/faq/svg-export-text-problems"
+       target="_blank"
+       id="a330">
+      <text
+         text-anchor="middle"
+         font-size="10px"
+         x="50%"
+         y="100%"
+         id="text328">Text is not SVG - cannot display</text>
+    </a>
+  </switch>
+</svg>
diff --git a/docs/how-to/hip_runtime_api/asynchronous.rst b/docs/how-to/hip_runtime_api/asynchronous.rst
index e7cc62849b..62791361de 100644
--- a/docs/how-to/hip_runtime_api/asynchronous.rst
+++ b/docs/how-to/hip_runtime_api/asynchronous.rst
@@ -180,6 +180,10 @@ Example
 
     .. tab-item:: asynchronous
 
+      .. figure:: ../../data/how-to/hip_runtime_api/asynchronous/async.svg
+        :alt: Asynchronous concurrency
+        :align: center
+
       .. code-block:: cpp
 
         #include <hip/hip_runtime.h>
@@ -256,6 +260,10 @@ Example
 
     .. tab-item:: hipStreamWaitEvent
 
+      .. figure:: ../../data/how-to/hip_runtime_api/asynchronous/event.svg
+        :alt: Asynchronous concurrency with events
+        :align: center
+
       .. code-block:: cpp
 
         #include <hip/hip_runtime.h>
@@ -347,6 +355,11 @@ Example
 
     .. tab-item:: sequential
 
+      .. figure:: ../../data/how-to/hip_runtime_api/asynchronous/sequential.svg
+        :alt: Asynchronous concurrency with events
+        :align: center
+
+
       .. code-block:: cpp
 
         #include <hip/hip_runtime.h>