Add dast documentation [TAROT-3247]

[joanasteodoro]

👀 Live preview

🚧 To do

• If relevant, include the Jira issue key at the end of the pull request title
• Perform a self-review of the changes
• Fix any issues reported by the CI/CD

[github-actions]

Overall readability score: 53.32 (🟢 +0.07)

File	Readability
roles-and-permissions-for-organizations.md	56.35 (🔴 -1.61)
managing-security-and-risk.md	52.68 (🟢 +0.6)
configuring-your-repository.md	30.06 (🔴 -0.37)
triggering-dast-scans.md	70.72 (-)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
roles-and-permissions-for-organizations.md	56.35	28.84	9.32	13.4	13.69	6.33
	🔴 -1.61	🔴 -8.26	🟢 +0	🟢 +0	🔴 -0.06	🔴 -0.05
managing-security-and-risk.md	52.68	34.46	10.73	14.3	13.58	6.65
	🟢 +0.6	🔴 -0.3	🔴 -0.04	🟢 +0.1	🟢 +0.34	🟢 +0.03
configuring-your-repository.md	30.06	26.85	16.18	17.9	13.7	8.71
	🔴 -0.37	🟢 +0	🔴 -0.12	🟢 +0	🟢 +0	🔴 -0.05
triggering-dast-scans.md	70.72	50.53	8.17	8.9	10.48	7.03
	-	-	-	-	-	-

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	53.32	42.76	10.86	12.63	12.68	7.96
	🟢 +0.07	🟢 +0	🟢 +0.01	🟢 +0.02	🟢 +0.01	🟢 +0

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[afsmeira]

In general, we are using DAST and App scanning interchangeably. For clarity, we should stick to a single nomenclature.

[claudiacodacy]

:dew_it:

[lventura-codacy]

Suggested change

	Check your [permissions](../../organizations/roles-and-permissions-for-organizations.md). Only git provider admins and organization managers will be able to create new targets and trigger scans (in app and via the API).
	Check your [permissions](../../organizations/roles-and-permissions-for-organizations.md). Only git provider admins and organization managers will be able to create new targets and trigger scans (either via Codacy's UI or API).

[lventura-codacy]

Suggested change

	- **ORGANIZATION:** Name of the organization on the Git provider. For example, `codacy`. You must have admin permissions over the organization on the Git provider.
	- **ORGANIZATION:** Name of the organization on the Git provider. For example, `codacy`. You must either be an organization manager or have admin permissions on the Git provider.

[lventura-codacy]

Suggested change

	**DAST_TARGET_ID:** Identifier of a DAST target to analyze (obtained in the [previous section](./triggering-dast-scans.md#creating-targets). For example, `457`. You must have admin permissions over the organization on the Git provider.
	**DAST_TARGET_ID:** Identifier of a DAST target to analyze (obtained in the [previous section](./triggering-dast-scans.md#creating-targets). For example, `457`. You must either be an organization manager or have admin permissions on the Git provider.

[claudiacodacy]

Suggested change

	**DAST_TARGET_ID:** Identifier of a DAST target to analyze (obtained in the [previous section](./triggering-dast-scans.md#creating-targets). For example, `457`. You must have admin permissions over the organization on the Git provider.
	**DAST_TARGET_ID:** Identifier of a DAST target to analyze (obtained in the [previous section](./triggering-dast-scans.md#creating-targets)). For example, `457`. You must either be an organization manager or have admin permissions on the Git provider.

[lventura-codacy]

Suggested change

	- **ORGANIZATION:** Name of the organization on the Git provider. For example, `codacy`. You must have admin permissions over the organization on the Git provider.
	- **ORGANIZATION:** Name of the organization on the Git provider. For example, `codacy`. You must either be an organization manager or have admin permissions on the Git provider.

[lventura-codacy]

Suggested change

	Scans occur asynchronously. To monitor an ongoing scan you can use the [target management page in Codacy](../../organizations/managing-security-and-risk.md#app-scanning). Once completed, you can access all scan results by navigating to the **Security dashboard**, selecting the **Findings tab** and filtering by **Scan types > DAST/App scanning**.
	Scans occur asynchronously. To monitor an ongoing scan you can use the [target management page in Codacy](../../organizations/managing-security-and-risk.md#app-scanning). Once a scan is completed, you can access all its results by navigating to the **Security dashboard**, selecting the **Findings tab** and filtering by **Scan types > DAST/App scanning**.