-
Notifications
You must be signed in to change notification settings - Fork 22
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: add instructions on using repo finder #350
Conversation
Signed-off-by: Ben Selwyn-Smith <[email protected]>
Signed-off-by: Ben Selwyn-Smith <[email protected]>
docs/source/pages/using.rst
Outdated
--------------------------- | ||
Analyzing more dependencies | ||
--------------------------- |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it would be better to move this section as a subsection of Analyzing with an SBOM
. What do you think?
Signed-off-by: Ben Selwyn-Smith <[email protected]>
docs/source/pages/using.rst
Outdated
------------------------------------- | ||
Analyzing a locally cloned repository | ||
------------------------------------- | ||
|
||
If you have a local repository that you want to analyze, Macaron also supports running the analysis against a local repository. | ||
|
||
'''''''''''''''''' |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks like this line is added accidentally and is causing an error: https://github.com/oracle/macaron/actions/runs/5450632046/jobs/9916079385?pr=350#step:8:9763
Signed-off-by: Ben Selwyn-Smith <[email protected]>
docs/source/pages/using.rst
Outdated
|
||
.. note:: The Repository Finding feature currently only works for Java projects via SCM meta data found within artifact POM files. | ||
|
||
This feature is enabled by default. To disable, or configure its behaviour in other ways, a custom ``defaults.ini`` should be passed to Macaron during execution. Under the ``repofinder.java`` header, five options exist: ``find_repos``, ``artifact_repositories``, ``repo_pom_paths``, ``find_parents``, ``artifact_ignore_list``. These options behave as follows: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It would be helpful to add a reference like this:
See :ref:`dump-defaults <reference to docs/source/pages/cli_usage/action_dump_defaults.rst >`, the CLI command to dump the default configurations in ``defaults.ini``. After making changes, see :ref:`analyze <analyze-action-cli>` CLI command for the option to pass the modified ``defaults.ini`` file.
You need to add a reference in docs/source/pages/cli_usage/action_dump_defaults.rst
but analyze-action-cli
reference already exists.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've tried to. Not sure if it's displaying as it should be though.
Signed-off-by: Ben Selwyn-Smith <[email protected]>
Signed-off-by: Ben Selwyn-Smith <[email protected]>
Adds instructions for using the repo finder feature to the "using" docs page.