feat(API): improve delete /projects/{project_id}/screenshots/{id} documentation

[Stephen Lumenta (sbl)]

Improves the documentation for delete /projects/{project_id}/screenshots/{id}: sharper descriptions, parameter docs, error responses, and usage examples.

Drafted with AI assistance and grounded in the API implementation. Please review for technical accuracy before merging; nothing is merged automatically.

🤖 Generated with Claude Code

[github-actions]

API changelog (oasdiff)

Doc-only edits (descriptions, examples) do not appear here.

2 changes: 0 error, 0 warning, 2 info
info	[api-security-added] at doc/compiled.json
	in API DELETE /projects/{project_id}/screenshots/{id}
		the endpoint scheme security `OAuth2` was added to the API

info	[api-security-added] at doc/compiled.json
	in API DELETE /projects/{project_id}/screenshots/{id}
		the endpoint scheme security `Token` was added to the API