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

generic fetcher: Add usage docs #718

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

kosciCZ
Copy link
Contributor

@kosciCZ kosciCZ commented Nov 1, 2024

Add documentation on how to use the generic fetcher and also an ADR to help move out of the experimental phase.

I've tried to follow the CONTRIBUTING.md guidelines, but since I did not see any previous ADR, I just tried to come up with something. Feel free to give more direction on how you want the docs to look like. Thanks!

Maintainers will complete the following section

  • Commit messages are descriptive enough
  • Code coverage from testing does not decrease and new code is covered
  • Docs updated (if applicable)
  • Docs links in the code are still valid (if docs were updated)

Note: if the contribution is external (not from an organization member), the CI
pipeline will not run automatically. After verifying that the CI is safe to run:

@brunoapimentel
Copy link
Contributor

/ok-to-test

@brunoapimentel
Copy link
Contributor

brunoapimentel commented Nov 1, 2024

We also add a tiny introduction of each package manager here: https://github.com/containerbuildsystem/cachi2/blob/main/README.md#package-managers. We should have one for generic.

@kosciCZ kosciCZ force-pushed the generic-fetcher-docs branch 3 times, most recently from e5286c0 to d8a3f6e Compare November 4, 2024 10:06
Copy link
Contributor

@brunoapimentel brunoapimentel left a comment

Choose a reason for hiding this comment

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

This LGTM in the overall.

I think we should split the ADR to a separate commit, or even have it in a separate PR. The reason is that I think we'll merge the docs very quickly, but the ADR also implies making the package manager officially supported, so it'll bring a longer discussion (and we could use the same PR to also remove it from dev-package-managers).

docs/adr/0001-add-generic-fetcher.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
This commit adds generic fetcher to the documentation as an experimental
package manager, with instructions on usage.

Signed-off-by: Jan Koscielniak <[email protected]>
@kosciCZ
Copy link
Contributor Author

kosciCZ commented Nov 6, 2024

I have removed the ADR from this PR and will move it into a separate MR so docs can potentially be merged first.

@kosciCZ kosciCZ changed the title generic fetcher: Add usage docs and a ADR generic fetcher: Add usage docs Nov 6, 2024
@brunoapimentel
Copy link
Contributor

/ok-to-test

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.

2 participants