Documentation/Nightly/Developers/FAQ/SVNtoGitHub

From Slicer Wiki
Revision as of 02:52, 13 March 2020 by JChris.FillionR (talk | contribs)
Jump to: navigation, search
Home < Documentation < Nightly < Developers < FAQ < SVNtoGitHub


SVNtoGitHub

What happen to the existing Slicer GitHub repository ?

Between 2011 and March 2020, Slicer sources were maintained in a SVN repository automatically mirrored on GitHub. To speedup time required to checkout Slicer source code, large data files have been removed from the Slicer commit history.

To ensure existing references to both Git SHA and Pull Requests are reachable, the mirrored GitHub repository has been renamed to https://github.com/Slicer/SlicerGitSVNArchive

Where are the data files removed from the filtered history ?

Before filtering the history, we made sure all large data files were effectively removed from the latest version and downloaded using either ExternalData CMake module or SampleData Slicer module.

For older version, each commit introducing large files has been updated by removing the large files and updating the file GIT_MIGRATION_DATA_REMOVED.txt by listing the corresponding SHA256 and file paths.

Corresponding files have been uploaded as release assets named <filename>_<sha256>. See https://github.com/Slicer/SlicerGitMigrationDataRemoved/releases


What is the SlicerGitSVNArchive repository ?

This corresponds to the original GitHub repository that was a mirror of the Slicer SVN authoritative repository. The former Slicer/Slicer repository was renamed into Slicer/SlicerGitSVNArchive

What happen to the SVN repository ?

Until September 2020, SVN server http://svn.slicer.org hosting the Dart, NAMICSandBox, Slicer3, Slicer3-lib-mirrors and Slicer4 repositories will remain available.

The web server http://viewvc.slicer.org/ will be converted into a static html website.

What happen to the Mantis issue tracker ?

Mantis issue tracker has been retired and new issues should be created here: https://github.com/Slicer/Slicer/issues

For every mantis issues, a GitHub issue has been created with a link to the retired mantis tracker.

To support this, the following redirections have been established:

Slicer4 project has been disabled in Mantis. This means that no issues will be visible on the main page and that user will not be able to create issues in mantis.

How to update the forked origin of your online Slicer fork ?

Following the rename of Slicer to SlicerGitSVNArchive, existing GitHub fork are referencing the "incorrect" repository:

Slicer-fork-reference-SlicerGitSVNArchive.png

To address this, you may delete your fork and re-fork https://github.com/Slicer/Slicer

If there are branches published on your fork that you would like to keep, you have two options:

  • clone your Slicer fork locally so that you could rebase and re-publish your branches
  • rename your Slicer fork to SlicerGitSVNArchive

How to update existing Slicer custom application ?

To ensure Slicer sources can be checked out using the provided Git SHA, in CMakeLists.txt file, replace lines like:

 GIT_REPOSITORY git://github.com/Slicer/Slicer

with

 GIT_REPOSITORY git://github.com/Slicer/SlicerGitSVNArchive