-
Notifications
You must be signed in to change notification settings - Fork 2.2k
Add the FAQ in the repository #5167
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
Conversation
chrisd8088
left a comment
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 great! I noted some minor typos only.
| To fix this, you can use `git lfs migrate import --everything` with an | ||
| appropriate `--include` argument. For example, if you wanted to move your | ||
| `.jpg` and `.png` files into Git LFS, you can do that with | ||
| `git lfs migrate import --everything --include="\*.jpg,*.png"`. More complicated |
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.
Just out of interest, is there a difference here between \* and plain *?
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.
This is required to make AsciiDoc not consider this bold. Very fortunately, it's also syntactically correct according to the shell.
I realized we should put this in section 7 of the manual.
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.
We generally get a lot of requests for problems that are already answered in the FAQ. Right now, this lives in the wiki, but this is hard to find, so let's include it in the documentation with Git LFS itself. Add the relevant portions to the binary and Makefile so that it can be accessed using `git lfs help faq`, and add it as well to the Linux packages.
Explain what a pointer file is and how to check out files with `git lfs pull`.
It's been requested that we add documentation to explain how to track files that already exist. Do so in a FAQ entry.
Now that the FAQ is stored in the repository, let's point people there instead of at the wiki.
Right now, people have to read the FAQ on the wiki, which makes it hard to discover or to use offline. We want people to have a copy of it installed as part of the documentation for ease of discovery. Add it to the repository, and add a couple of missing entries to help explain some situations we haven't mentioned yet.
Fixes #5034