Readme #readme back to top

A README, Code of conduct, Contributing guidelines, License, Security policy, Issue templates, and Pull request template should all exist in each repository. The 10up standard for each of these (except README and LICENSE) is represented in the 10up .github repository and will appear in all 10up repositories unless a local one is created, so feel free to leverage the default files unless it’s necessary and reasonable to create custom ones for a given repository.

README outline

Each file should follow a similar outline including the items below (as feasible and makes sense).

Title and Description

Ideally we have a (less than 100px in height) logo image we can use with the repository name as fallback. Below that should be the description in pullquote form. Finally any applicable badges for the repository should be displayed (e.g., build status, code coverage, stable release version, support level, WP tested up to, license, dependencies, number of contributors).


List short bulleted items on the major features/benefits of the plugin/toolkit. After the bulleted list, we should end with “For more details on changes in each release, check out”


This is an optional section, but should be included and list WordPress, PHP, etc. versions that are required as well as any additional plugins/themes/etc. for the plugin/tool to function properly.


This is an optional section, but should include any unique install steps besides the normal “search in WP Admin” / “upload ZIP” steps.


This is an optional section, but should include simple screenshots and basic instructions for any setup or settings required to configure the plugin/tool.

Support Level

Check the Support Levels section for details on what to include here.

Known Caveats / Issues

This is an optional section, but should include any issues, bugs, or things to note about the plugin/tool that a user might encounter while using it.


This is a required section, should link out to the respective file, and should follow our documented approach within the file as noted in the Releasing Code section. See ClassifAI as an example.


Verbatim with correct MD file links: “Please read for details on our code of conduct, for details on the process for submitting pull requests to us, and for a list of maintainers, contributors, and libraries used in this repository.”

10up promo

At the end of the README should be the standard 10up Hiring promotion image with a link back to See examples on Distributor and ClassifAI.

Code of Conduct #code-of-conduct back to top

10up has standardized to the Contributor Covenant version of a Code of Conduct file, currently version 1.4. We also utilize the community-wide community health file functionality from GitHub, so any project that doesn’t include it’s own file will inherit the default 10up version. Projects may chose to include their own version of the Contributor Covenant or rely upon the 10up default version.

Contributing Guidelines #contributing back to top

10up has standardized the ways in which we expect 10up, our project Maintainers, and community contributions to interrelate when contributing to our open source projects. These are defined in our default file that will be inherited by any projects that do not have their own file. Projects may chose to include their own version of the file or rely upon the 10up default version.