[![CC BY 4.0][cc-by-shield]][cc-by]
[![Discord](https://img.shields.io/discord/1296917489615110174?label=discord&logo=discord&logoColor=#5865F2)](https://discord.gg/9HFMDMt95z)
[![Google
Group](https://img.shields.io/badge/mailing_list-blue)](https://groups.google.com/g/twelve-factor)

# The Twelve-Factor Manifesto

This is the repository for the text of the updated version of the twelve-factor
manifesto, which will ultimately replace the one hosted at
[12factor.net](https://12factor.net). The text is located in the [content
directory](content). As noted in the [governance document](GOVERNANCE.md),
changes will occur in the
[next](https://github.com/twelve-factor/twelve-factor/tree/next) branch until
the maintainers agree that the current round of updates is complete.

## Vision

The details of our vision for the update can be found in [VISION.md](VISION.md)

## How to Participate

Information on participating is in [CONTRIBUTING.md](CONTRIBUTING.md)

## Additional Information

- **Governance**: Read more about the project's governance and decision-making
  process in [GOVERNANCE.md](GOVERNANCE.md).
- **Code of Conduct**: We use the [Contributor
  Covenant](https://www.contributor-covenant.org/) and expect all contributors
  to follow it.
- **Questions?** If you have any questions or need help, feel free to join the
  discussion on GitHub or reach out to a [maintainer](MAINTAINERS.md).
- **Prior Art**:
  - [https://www.oreilly.com/library/view/beyond-the-twelve-factor/9781492042631/](https://www.oreilly.com/library/view/beyond-the-twelve-factor/9781492042631/)  
  - Nginx amendments (deleted from their site, but present in [https://slidrio-decks.global.ssl.fastly.net/1020/original.pdf](https://slidrio-decks.global.ssl.fastly.net/1020/original.pdf))
  - [https://www.cncf.io/blog/2022/04/28/twelve-factor-app-anno-2022/](https://www.cncf.io/blog/2022/04/28/twelve-factor-app-anno-2022/)
  - [https://lab.abilian.com/Tech/Cloud/The%2012%20Factor%20App/](https://lab.abilian.com/Tech/Cloud/The%2012%20Factor%20App/)
  - [https://www.ibm.com/blog/7-missing-factors-from-12-factor-applications/](https://www.ibm.com/blog/7-missing-factors-from-12-factor-applications/)

## Update Frequently Asked Questions

- [What is this?](UPDATE_FAQ.md#what-is-this)
- [Why now?](UPDATE_FAQ.md#why-now)
- [Why isn't \[my favorite software development principle\] a factor?](UPDATE_FAQ.md#why-isnt-my-favorite-software-development-principle-a-factor)
- [Who’s helping and why?](UPDATE_FAQ.md#whos-helping-and-why)
- [Will there always be twelve factors?](UPDATE_FAQ.md#will-there-always-be-twelve-factors)
- [What’s not changing?](UPDATE_FAQ.md#whats-not-changing)
- [What is changing?](UPDATE_FAQ.md#what-is-changing)
- [Are you just updating the examples?](UPDATE_FAQ.md#are-you-just-updating-the-examples)

This work is licensed under a
[Creative Commons Attribution 4.0 International License][cc-by].

[![CC BY 4.0][cc-by-image]][cc-by]

[cc-by]: http://creativecommons.org/licenses/by/4.0/
[cc-by-image]: https://i.creativecommons.org/l/by/4.0/88x31.png
[cc-by-shield]: https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg