1
0
mirror of synced 2025-12-23 11:54:18 -05:00
Files
docs/content/github/managing-large-files/collaboration-with-git-large-file-storage.md
Emily Gould a06ea17a4b Make Building a strong community a top-level doc set (#18396)
* Move directory to new location

* Update new index page

* Create wikis category

* Create blocking category

* Create moderation category

* Make map topics into category indexes

* Create contributions category

* Create template category

* Add redirects

* Add new product to products.yml

* Rename product for URL purposes

* Update links to wiki content

* Update links to maintaining safety articles

* Update links to moderation content

* Remove old category from github product index

* Fix links

* Update links to healthy contributions articles

* Update links to template articles

* Fix links
2021-03-29 16:40:32 -05:00

2.9 KiB

title, intro, redirect_from, versions
title intro redirect_from versions
Collaboration with Git Large File Storage With {% data variables.large_files.product_name_short %} enabled, you'll be able to fetch, modify, and push large files just as you would expect with any file that Git manages. However, a user that doesn't have {% data variables.large_files.product_name_short %} will experience a different workflow.
/articles/collaboration-with-large-file-storage/
/articles/collaboration-with-git-large-file-storage
free-pro-team enterprise-server github-ae
* * *

If collaborators on your repository don't have {% data variables.large_files.product_name_short %} installed, they won't have access to the original large file. If they attempt to clone your repository, they will only fetch the pointer files, and won't have access to any of the actual data.

{% tip %}

Tip: To help users without {% data variables.large_files.product_name_short %} enabled, we recommend you set guidelines for repository contributors that describe how to work with large files. For example, you may ask contributors not to modify large files, or to upload changes to a file sharing service like Dropbox or Google Drive. For more information, see "Setting guidelines for repository contributors."

{% endtip %}

Viewing large files in pull requests

{% data variables.product.product_name %} does not render {% data variables.large_files.product_name_short %} objects in pull requests. Only the pointer file is shown:

Sample PR for large files

For more information about pointer files, see "About {% data variables.large_files.product_name_long %}."

To view changes made to large files, check out the pull request locally to review the diff. For more information, see "Checking out pull requests locally."

{% if currentVersion == "free-pro-team@latest" %}

Pushing large files to forks

Pushing large files to forks of a repository count against the parent repository's bandwidth and storage quotas, rather than the quotas of the fork owner.

You can push {% data variables.large_files.product_name_short %} objects to public forks if the repository network already has {% data variables.large_files.product_name_short %} objects or you have write access to the root of the repository network.

{% endif %}

Further reading