Skip to content
| Marketplace
Sign in
Azure DevOps>Azure Pipelines>YAML Documentation Generator
YAML Documentation Generator

YAML Documentation Generator

Richard Fennell (Black Marble)

|
481 installs
| (1) | Free
A task that generates YAML documentation for an Azure DevOps Extension.
Get it free

This set of tasks generate YAML documentation

Generate YAML Documentation

The YAML documenter task uses the task.json files within an extension package to build YAML documentation. It can also copy the extensions readme.md to the same output location as the generated YAML file. The file name formats would be

  • fileprefix-YAML.md
  • fileprefix.md

It is assumed that the file generated will be uploaded to some location, such as a WIKI, by another task.

Usage

Add the task to a build or release

Required Parameters

  • Source Directory - The root of the extension source, where the vss-extension.json file is
  • Output Directory - Where to write the output markdown file to.

Optional Advanced Parameters

  • FilePrefix - The output filename prefix, if not set the extension ID will be used from the vss-extension.json file
  • CopyReadme - If true will also copy the readme.md for the extension with the same file prefix as the YAML
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2025 Microsoft