We are planning to move CABLE from an SVN/TRAC-based repository to a git/GitHub-based repository. We will use this forum to communicate information about the changes.
The simplest way to stay informed about the move of CABLE to GitHub is to watch the cable-to-git tag (you will need to sign up for the forum first if you haven’t already). To watch the tag, go to this page and click the icon on the top right. You can then choose the level of notification that is appropriate to you. Know that “watch” is the strongest level and will email you all activities on topics with the cable-to-git tag.
If you do not want notifications, all topics on the subject will be tagged with cable-to-git so you can search for this tag on the forum to find the information.
The CABLE SVN repository and the TRAC tickets will be moved to be hosted by GitHub and to use git as a version control system. The documentation is also in the process of being rewritten and hosted by Read the Docs.
At this time, the datasets in CABLE-AUX will stay under SVN and the TRAC site and will move on at a later date.
At this stage, we estimate moving CABLE from SVN to GitHub will take a day. From that day, the access to the SVN repository will be restricted to read-only so all work on editing the CABLE code source should be paused for that day.
After the transition, all activity on CABLE will happen on GitHub, using git. The current SVN repository and Trac site will stay accessible but in read-only mode.
The SVN repository and Trac site will be definitely removed about 7 years after the transition. This time frame was chosen as some publications may have used the Trac URL to refer to specific CABLE versions and these should be accessible for 7 years.
We know this transition is a big change and we would like to ensure everyone will be able to adapt in the best conditions. In the coming weeks, there will be various information being released such as new working practices for CABLE with the git/GitHub workflow and a git/GitHub training. We also need you to take a few actions now.
Tell us, by replying on this forum topic, what concerns you have about the transition so we can work with you to prepare for it. In particular, we would like to know if you need time before the transition to adapt existing workflows or other preparation work, and how much time would be needed. At this time, the transition could happen as early as late November unless users need more time.
We need you to tell us which branches of the CABLE repository should be carried over to GitHub, by Friday 27 October. Please go to this topic for more details and reply there with your important branches.
Learn Git and GitHub. There are plenty of resources around to learn Git. Searching for “Git Tutorial” on YouTube will give you many options. You can also use:
We will also soon release a short training targeted specifically at how we will use Git for CABLE.