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: add a note in pkg_tar#strip_prefix docs (v.0.8.0) about flattening #699

Merged
merged 3 commits into from
Jun 5, 2023

Conversation

jhchabran
Copy link
Contributor

Hey folks, here is a very inconsequential PR which could save some time to new users.

From the perspective of someone who just started using rules_pkg, I was really confused to learn that if I don't want to flatten the files structure I have to use the undocumented strip_prefix = "." magic trick.

While there is an ongoing discussion over #354 on this precise issue, I feel that it would save a lot a time for new users stumbling across this problem by having a quick note in the existing docs, while the conversation continues over there.

@jhchabran jhchabran requested review from aiuto, nacl and jylinv0 as code owners May 15, 2023 18:14
@jhchabran jhchabran changed the title docs: add a note in pkg_tar#strip_prefix about flattening docs: add a note in pkg_tar#strip_prefix docs (v.0.8.0) about flattening May 15, 2023
@aiuto
Copy link
Collaborator

aiuto commented May 18, 2023

It would be more useful to correct the text in the code and regenerate the docs.
Of course, it's hard to regenerate 0.8.0 docs, so this change is still needed too.

@jhchabran jhchabran force-pushed the 8.0-docs-note-about-strip_prefix branch from 0473234 to 5dddacc Compare May 27, 2023 06:37
@jhchabran jhchabran force-pushed the 8.0-docs-note-about-strip_prefix branch from 5dddacc to aea720b Compare May 27, 2023 06:38
@jhchabran
Copy link
Contributor Author

@aiuto updated :)

Copy link
Collaborator

@aiuto aiuto left a comment

Choose a reason for hiding this comment

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

I have no idea why the tests are failling

@aiuto
Copy link
Collaborator

aiuto commented Jun 5, 2023

Going to try to merge and then I will fix tests after.

@aiuto aiuto merged commit 2532314 into bazelbuild:main Jun 5, 2023
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