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

Added explicit steps for configuring and using custom rules. #276

Merged
merged 6 commits into from
Aug 10, 2024

Conversation

Myrausman
Copy link
Contributor

Fixes #212

Signed-off-by: Maira Usman <maira.usman5703@gmail.com>
Copy link
Member

@jwmatthews jwmatthews left a comment

Choose a reason for hiding this comment

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

Thank you for the contribution.

Please consider the comments I added to help improve the documentation and clear up confusion with the 2 places we run analysis.

docs/customApps.md Outdated Show resolved Hide resolved
Signed-off-by: Maira Usman <maira.usman5703@gmail.com>
@Myrausman
Copy link
Contributor Author

@jwmatthews , Can you please confirm if this is the content you meant to include in the document?

Copy link
Member

@jwmatthews jwmatthews left a comment

Choose a reason for hiding this comment

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

Let's:

  1. Remove the statement about ignoring default rules on the sample data analysis which is not applicable
  2. Relocate the note on the 2 places analysis occurs to end of document and put in it's own section

To ensure the analysis uses the necessary custom rules, follow these steps:

1. Custom Rules: Download or create your custom rules and place them in the samples/custom_rules directory.
2. Ignore Default Rules: The analysis script is set to ignore default Kantra rules. You can review or adjust this in example/analyze.sh if needed.
Copy link
Member

Choose a reason for hiding this comment

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

@Myrausman this information you have is not technically correct, as the section you are documenting will NOT ignore default rules. That is why I gave you more context so you could fully understand the 2 places we run analysis.

The documentation for this section:
https://github.com/konveyor/kai/blob/1ed90050c210c5a3597b0ef1a073eb41f4843008/docs/customApps.md#run-analysis

Is talking about how to run the analysis for the sample data which Kai will consult.
That analysis DOES NOT ignore default rules.

Please remove:
2. Ignore Default Rules: The analysis script is set to ignore default Kantra rules. You can review or adjust this in example/analyze.sh if needed.

docs/customApps.md Outdated Show resolved Hide resolved
Signed-off-by: Maira Usman <maira.usman5703@gmail.com>
Copy link
Member

@jwmatthews jwmatthews left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Member

@jwmatthews jwmatthews left a comment

Choose a reason for hiding this comment

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

Almost ready, but need to adjust a trunk fmt issue

Please see https://github.com/konveyor/kai/blob/main/CONTRIBUTING.md#linting for how to install/run trunk to fix this.

Signed-off-by: Myrausman <maira.usman5703@gmail.com>
@jwmatthews jwmatthews merged commit b4ecf36 into konveyor:main Aug 10, 2024
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Docs] Update demo.md to specifically call out how to invoke with our custom rules
2 participants