diff --git a/tools/topology/topology2/include/pipelines/volume-playback.conf b/tools/topology/topology2/include/pipelines/volume-playback.conf
index d04830b21..fa007609a 100644
--- a/tools/topology/topology2/include/pipelines/volume-playback.conf
+++ b/tools/topology/topology2/include/pipelines/volume-playback.conf
@@ -1,24 +1,26 @@
-#
-# Volume playback pipeline
-#
-# A simple pipeline. All attributes defined herein are namespaced by alsatplg to
-# "Object.Pipeline.volume-playback.N.attribute_name"
-#
-# Usage: this component can be used by declaring in the top-level topology conf file as follows:
-#
-# 	Object.Pipeline.volume-playback."N" {
-#		format		"s16le"
-#		period		1000
-#		time_domain	"timer"
-#		channels	2
-#		rate		48000
-#	}
-#
-# where N is the unique pipeline_id for this pipeline object within the same alsaconf node.
-#
-#
-# (source) host.N.playback -> buffer.N.1 -> volume.N.1 -> buffer.N.2 (sink endpoint)
-#
+## \struct volume_playback
+## \brief Volume playback pipeline
+##
+## \par Instantiating volume-playback pipeline
+##
+## A simple pipeline. All attributes defined herein are namespaced by alsatplg
+## to "Object.Pipeline.volume-playback.N.attribute_name"
+##
+## Usage: this component can be used by declaring in the top-level topology conf file as follows:
+##
+## 	Object.Pipeline.volume-playback."N" {
+##			format		"s16le"
+##			period		1000
+##			time_domain	"timer"
+##			channels	2
+##			rate		48000
+##		}
+##
+## where N is the unique pipeline_id for this pipeline object within the same alsaconf node.
+##
+##
+## (source) host.N.playback -> buffer.N.1 -> volume.N.1 -> buffer.N.2 (sink endpoint)
+##
 
 <include/common/route.conf>
 <include/components/buffer.conf>
@@ -31,7 +33,7 @@ Class.Pipeline."volume-playback" {
 	<include/pipelines/pipeline-common.conf>
 
 	attributes {
-		# pipeline name is constructed as "volume-playback.1"
+		## pipeline name is constructed as "volume-playback.1"
 		!constructor [
 			"index"
 		]
@@ -49,9 +51,11 @@ Class.Pipeline."volume-playback" {
 	}
 
 	Object.Widget {
+		## The pipeline object for captured playback
 		pipeline."1" {}
 
 		host."playback" {
+			## "aif_in" is for playback
 			type			"aif_in"
 		}