diff --git a/internal/target/azure_target.go b/internal/target/azure_target.go
index 458c9ae1e..f60642319 100644
--- a/internal/target/azure_target.go
+++ b/internal/target/azure_target.go
@@ -9,6 +9,16 @@ type AzureTargetOptions struct {
 
 func (AzureTargetOptions) isTargetOptions() {}
 
+// NewAzureTarget creates org.osbuild.azure target
+//
+// This target uploads a Page Blob to Azure Storage.
+//
+// The target uses Azure Storage keys for authentication, see:
+// https://docs.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage
+// The credentials are defined inside the target options.
+//
+// If you need to upload an Azure Image instead, see the
+// org.osbuild.azure.image target.
 func NewAzureTarget(options *AzureTargetOptions) *Target {
 	return newTarget("org.osbuild.azure", options)
 }