Writing Documentation

Documentation is important for themes as it provides a way for users to understand what a theme does and does not support. Likewise, documenting the code of your theme will make it easier for other theme developers to customize your theme, likely with a child theme.

Here’s a list of requirements and recommendations for your theme’s documentation.

  • Themes are required to provide end-user documentation of any design limitations or extraordinary installation/setup instructions.
  • Themes are required to include a readme.txt file, using the plugin directory’s readme.txt markdown format. New themes need to follow this rule as of October 25th, 2018. Old themes have a 6 months grace time from this date.