Add asynchronous concurrent execution

.wordlist.txt

@@ -7,7 +7,7 @@ APUs
 AQL
 AXPY
 asm
-Asynchrony
+asynchrony
 backtrace
 Bitcode
 bitcode
@@ -118,6 +118,7 @@ overindexing
 oversubscription
 overutilized
 parallelizable
+parallelized
 pixelated
 pragmas
 preallocated

docs/how-to/hip_runtime_api.rst

@@ -40,6 +40,7 @@ Here are the various HIP Runtime API high level functions:
 * :doc:`./hip_runtime_api/initialization`
 * :doc:`./hip_runtime_api/memory_management`
 * :doc:`./hip_runtime_api/error_handling`  
+* :doc:`./hip_runtime_api/asynchronous`
 * :doc:`./hip_runtime_api/cooperative_groups`
 * :doc:`./hip_runtime_api/hipgraph`
 * :doc:`./hip_runtime_api/call_stack`

docs/how-to/performance_guidelines.rst

@@ -3,6 +3,8 @@
    developers optimize the performance of HIP-capable GPU architectures.
   :keywords: AMD, ROCm, HIP, CUDA, performance, guidelines
 
+.. _how_to_performance_guidelines:
+
 *******************************************************************************
 Performance guidelines
 *******************************************************************************
@@ -32,12 +34,14 @@ reveal and efficiently provide as much parallelism as possible. The parallelism
 can be performed at the application level, device level, and multiprocessor
 level.
 
+.. _application_parallel_execution:
+
 Application level
 --------------------------------------------------------------------------------
 
 To enable parallel execution of the application across the host and devices, use
-asynchronous calls and streams. Assign workloads based on efficiency: serial to
-the host or parallel to the devices.
+:ref:`asynchronous calls and streams <asynchronous_how-to>`. Assign workloads
+based on efficiency: serial to the host or parallel to the devices.
 
 For parallel workloads, when threads belonging to the same block need to
 synchronize to share data, use :cpp:func:`__syncthreads()` (see:

docs/sphinx/_toc.yml.in

@@ -49,9 +49,10 @@ subtrees:
           - file: how-to/hip_runtime_api/memory_management/virtual_memory
           - file: how-to/hip_runtime_api/memory_management/stream_ordered_allocator
       - file: how-to/hip_runtime_api/error_handling
-      - file: how-to/hip_runtime_api/cooperative_groups
-      - file: how-to/hip_runtime_api/hipgraph
       - file: how-to/hip_runtime_api/call_stack
+      - file: how-to/hip_runtime_api/asynchronous
+      - file: how-to/hip_runtime_api/hipgraph
+      - file: how-to/hip_runtime_api/cooperative_groups
       - file: how-to/hip_runtime_api/multi_device
       - file: how-to/hip_runtime_api/opengl_interop
       - file: how-to/hip_runtime_api/external_interop