revi-archive/phorge-phorge
1
0
Fork 0
mirror of https://we.phorge.it/source/phorge.git synced 2024-11-19 13:22:42 +01:00
Code Issues Releases Wiki Activity

Use more precise language to describe what mirroring is

Browse source 
Summary: Fixes T10928. This behavior hasn't changed at all and this is what, e.g., `git push --mirror` means, and the other behavior isn't possible, but be more explicit about the inherent destructive potential of mirroring.

Test Plan: Read documentation.

Reviewers: chad, sascha-egerer

Reviewed By: sascha-egerer

Subscribers: sascha-egerer

Maniphest Tasks: T10928

Differential Revision: https://secure.phabricator.com/D15861
This commit is contained in:
epriestley 2016-05-06 07:56:08 -07:00
parent fde02c4b4e
commit cc579be6f1
1 changed files with 11 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
src/docs/user/userguide/diffusion_uris.diviner
View file

@ -23,9 +23,9 @@ is hosted elsewhere (like GitHub or Bitbucket) and track updates to the remote
repository. This will create a read-only copy of the repository in Phabricator. repository. This will create a read-only copy of the repository in Phabricator.
**Mirror Repositories**: Phabricator can publish any repository to mirrors, **Mirror Repositories**: Phabricator can publish any repository to mirrors,
updating the mirrors as changes are made to the repository. This works with overwiting them with an exact copy of the repository that stays up to date as
both local hosted repositories and remote repositories that Phabricator is the source changes. This works with both local repositories that Phabricator is
observing. hosting and remote repositories that Phabricator is observing.
**Proxy Repositories**: If you are observing a repository, you can allow users **Proxy Repositories**: If you are observing a repository, you can allow users
to read Phabricator's copy of the repository. Phabricator supports granular to read Phabricator's copy of the repository. Phabricator supports granular
@ -102,12 +102,19 @@ Mirror a Repository
NOTE: Mirroring is not supported in Subversion. NOTE: Mirroring is not supported in Subversion.
You can create a read-only mirror of an existing repository. Phabricator will You can create a read-only mirror of an existing repository. Phabricator will
push all changes made to the repository to the mirror. continuously publish the state of the source repository to the mirror, creating
an exact copy.
For example, if you have a repository hosted in Phabricator that you want to For example, if you have a repository hosted in Phabricator that you want to
mirror to GitHub, you can configure Phabricator to automatically maintain the mirror to GitHub, you can configure Phabricator to automatically maintain the
mirror. This is how the upstream repositories are set up. mirror. This is how the upstream repositories are set up.
The mirror copy must be read-only for users because any writes made to the
mirror will be undone when Phabricator updates it. The mirroring process copies
the entire repository state exactly, so the remote state will be completely
replaced with an exact copy of the source repository. This may remove or
destroy information. Normally, you should only mirror to an empty repository.
You can mirror any repository, even if Phabricator is only observing it and not You can mirror any repository, even if Phabricator is only observing it and not
hosting it directly. hosting it directly.