Teddy.gesbert/doc dora (#29393)

* Replaced incidents by failures

* v1

* v1.1

* Little update of some requirements (DORA settings)

* Upper case small changes

* Update content/en/dora_metrics/data_collected/_index.md

Co-authored-by: Jorge Calvar <[email protected]>

* Applied feedback from Jorge

Change deployment.merge_time to Merge Time (i.e. metric to field) to avoid any confusion with previous Metrics type

* Applied feedback from Guillaume

* Fix typos and improve consistency in DORA metrics documentation

Applied suggestions from Joe Peeples

* Applying Joe's feedback and fixing small tweak

* Added Incident Management as a DORA Failure data source

* Update content/en/dora_metrics/setup/failures.md

Co-authored-by: Alicia Scott <[email protected]>

* Update content/en/dora_metrics/setup/failures.md

Co-authored-by: Alicia Scott <[email protected]>

* Applied feedback from alicia

- Added consistency between data sources requirements.
- Remove /dora_metrics/failures/datadog_incidents alias as not needed.

* Applied feedback from Jorge

* Update content/en/dora_metrics/setup/failures.md

Co-authored-by: Alicia Scott <[email protected]>

* Update failures.md

* Added backfill documentation

Added backfill documentation for retrieving past incidents using Incident Management as a DORA failure source.

* Update content/en/dora_metrics/setup/failures.md

Co-authored-by: May Lee <[email protected]>

* Update content/en/dora_metrics/setup/failures.md

Co-authored-by: May Lee <[email protected]>

* Update content/en/dora_metrics/setup/failures.md

Co-authored-by: May Lee <[email protected]>

* Added, TTR calculation + Pro tips

* Added more details on TTR calculation

* Removing Preview alert

Removing Preview alert + 2 small changes on definitions

* Update documentation to add rebase logic

---------

Co-authored-by: Jorge Calvar <[email protected]>
Co-authored-by: Alicia Scott <[email protected]>
Co-authored-by: May Lee <[email protected]>

Author: 4 people

content/en/dora_metrics/setup/deployments.md

@@ -301,6 +301,8 @@ If the two metadata entries are defined for a service, only `extensions[datadogh
 - When using "Squash" to merge pull requests:
   - For GitHub and GitLab: Metrics are emitted for the original commits.
   - For other Git providers: Metrics are emitted for the new commit added to the target branch.
+- When using "Rebase", either manually or to merge pull requests:
+  - For all Git providers: Metrics are emitted based on the original commit timestamps, while the displayed SHA corresponds to the newly created rebased commit.
 
 ## Calculating change failure rate