2022-04-25 12:03:02 +05:30
# Dex Enhancement Proposal
2022-04-22 15:49:15 +05:30
## Why do we need it?
2022-04-25 12:03:02 +05:30
Dex Enhancement Proposal (DEP) is a design document providing information to the community, or describing a new feature for Dex.
2022-04-22 15:49:15 +05:30
2022-04-25 12:03:02 +05:30
We intend DEPs to be the primary mechanisms for proposing major new features or significant changes to existing ones.
This will make it easier for the community to describe, track, and look through the history of changes that affected the development of the project.
2022-04-22 15:49:15 +05:30
## Process
### Before starting
2022-05-20 17:49:20 +05:30
1. Search GitHub for previous [issues ](https://github.com/dexidp/dex/issues ), [discussions ](https://github.com/dexidp/dex/discussions ) and [DEPs ](https://github.com/dexidp/dex/tree/master/docs/enhancements ).
2022-04-25 12:03:02 +05:30
2. If a discussion does not exist, [open it ](https://github.com/dexidp/dex/discussions/new?category=Ideas ).
2022-04-22 15:49:15 +05:30
3. Ensure that writing enhancement proposal is necessary for you change by discussing it with a community.
### Writing an enhancement proposal
1. Fork the repo.
2022-05-20 17:49:20 +05:30
2. Copy the [`docs/enhancements/_title-YYYY-MM-DD-#issue.md` ](docs/enhancements/_title-YYYY-MM-DD-#issue.md ) template with the appropriate
2022-04-22 15:49:15 +05:30
name.
3. Fill all sections according to hints in them. Provide as much information as you can.
4. Submit your PR and discuss it with the Dex team.