Add a FAQ entry on Jenkins problems #5177
Merged
+20
−2
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
Bin |
|
chrisd8088
approved these changes
Nov 28, 2022
docs/man/git-lfs-faq.adoc
Outdated
| + | ||
| Note that this prevents things like `git push` from pushing LFS objects and | ||
| locked files from being read only, since those are implemented by hooks. If you | ||
| need that functionality, you should contact the Jenkins documentation about how |
Member
There was a problem hiding this comment.
Maybe it's just me, but "contact" here feels slightly off (I suppose because documentation is inert). Perhaps "review"?
Member
Author
There was a problem hiding this comment.
Ah, yes. I originally said "contact the Jenkins project" or somesuch and failed to fix the verb.
The name of the `--skip-repo` option leads people to believe that it's incompatible with `--local`. Let's describe the option more accurately so that people know exactly what it does. Don't specifically mention the global LFS filters because one can indeed use local LFS filters with it as well. Capitalize "LFS", and specifically mention that any of the destination options may be used in conjunction with this option.
We've had several different reports about a Jenkins configuration change that intentionally provides an invalid hook path.. Document this in the FAQ to help people find a solution to this problem.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
We've recently some some problems where Jenkins sets
core.hooksPathto an invalid value (on Windows, notably this isNUL:). Let's address this with a FAQ entry to explain how to work around that if necessary.Also, in the course of writing this, it's been noted that the
--skip-repooption is confusing with regards to--local. These options are orthogonal and can be used together, so indicate that and update the documentation to better describe what the--skip-repooption does and how it can be used.Fixes #5171