Skip to main content

GitHub Actions Documentation Template

This template provides all available documentation sections for GitHub Actions. Copy and paste the sections you need into your README.md or documentation file.

Complete Template

<!-- header:start -->
<!-- header:end -->
<!-- badges:start -->
<!-- badges:end -->
<!-- overview:start -->
<!-- overview:end -->
<!-- usage:start -->
<!-- usage:end -->
<!-- inputs:start -->
<!-- inputs:end -->
<!-- secrets:start -->
<!-- secrets:end -->
<!-- outputs:start -->
<!-- outputs:end -->
<!-- examples:start -->
<!-- examples:end -->
<!-- contributing:start -->
<!-- contributing:end -->
<!-- security:start -->
<!-- security:end -->
<!-- license:start -->
<!-- license:end -->
<!-- generated:start -->
<!-- generated:end -->

Available Sections

SectionDescription
headerAction name and branding
badgesStatus badges and marketplace links
overviewDescription and key features
usageBasic usage examples
inputsInput parameter documentation
secretsRequired secrets documentation (For GitHub Workflows)
outputsOutput parameter documentation
examplesDetailed usage examples
contributingContributing guidelines
securitySecurity guidelines
licenseLicense information
generatedCI Dokumentor attribution

Usage Tips

  • Keep manual content outside markers: Place your custom documentation outside the <!-- section:start --> and <!-- section:end --> markers
  • Selective sections: Only include the sections you need - remove unused ones
  • Order matters: Arrange sections in a logical order for your users
  • Version references: Use pinned version tags