Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(devel-guide): Adding some improves and clarifications to developer guide #3749

Merged
merged 6 commits into from
Apr 12, 2024

Conversation

puchy22
Copy link
Member

@puchy22 puchy22 commented Apr 10, 2024

Context

There are some things in the developer guide that cannot be full understood to new users.

Description

Change services and checks docs pages to make more understandable for new users, adding new clarifications and fixing the error of Check FAIL status.

License

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@puchy22 puchy22 requested a review from a team April 10, 2024 11:55
Copy link
Member

@jfagoagas jfagoagas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great addition @puchy22 👏

Please review my comments to clarify some points and improve the copy.

docs/developer-guide/checks.md Outdated Show resolved Hide resolved
docs/developer-guide/checks.md Outdated Show resolved Hide resolved
We are going to use the `ec2_ami_public` check form the `AWS` provider as an example. So the folder name will `prowler/providers/aws/services/ec2/ec2_ami_public` (following the format `prowler/providers/<provider>/services/<service>/<check_name>`), with the name of check following the pattern: `service_subservice_resource_action`.

???+ note
A subservice is more specific part of a service that is gonna be audit. Sometime it could be the shortened name of the class attribute that is gonna be acceded in the check.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A subservice is more specific part of a service that is gonna be audit. Sometime it could be the shortened name of the class attribute that is gonna be acceded in the check.
A subservice is an specific component of a service that is gonna be audited. Sometimes it could be the shortened name of the class attribute that is gonna be accessed in the check.

docs/developer-guide/checks.md Outdated Show resolved Hide resolved
docs/developer-guide/checks.md Outdated Show resolved Hide resolved
docs/developer-guide/services.md Outdated Show resolved Hide resolved
@jfagoagas jfagoagas self-requested a review April 11, 2024 09:12
jfagoagas
jfagoagas previously approved these changes Apr 11, 2024
Copy link
Member

@jfagoagas jfagoagas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔝

docs/developer-guide/checks.md Outdated Show resolved Hide resolved
jfagoagas
jfagoagas previously approved these changes Apr 11, 2024
Copy link
Member

@jfagoagas jfagoagas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🥇

@jfagoagas jfagoagas merged commit 026fff7 into prowler-cloud:master Apr 12, 2024
16 of 18 checks passed
sergargar pushed a commit that referenced this pull request Apr 15, 2024
@puchy22 puchy22 deleted the improve_devel_guide branch April 30, 2024 07:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants