Skip to content
Snippets Groups Projects
Commit 6d7b825c authored by Vermaat's avatar Vermaat
Browse files

Update documentation for GitLab->GitHub move

parent df781fe9
No related branches found
No related tags found
No related merge requests found
...@@ -5,8 +5,8 @@ ...@@ -5,8 +5,8 @@
Development Development
=========== ===========
Development of Mutalyzer happens on GitLab: Development of Mutalyzer happens on GitHub:
https://git.lumc.nl/mutalyzer/mutalyzer https://github.com/LUMC/mutalyzer
Contributing Contributing
...@@ -53,21 +53,23 @@ Working with feature branches ...@@ -53,21 +53,23 @@ Working with feature branches
New features are best implemented in their own branches, isolating the work New features are best implemented in their own branches, isolating the work
from unrelated developments. In fact, it's good practice to *never work from unrelated developments. In fact, it's good practice to *never work
directly on the master branch* but always in a separate branch. For this directly on the master branch* but always in a separate branch. When your work
reason, the master branch on the GitLab server is locked. Feature branches can is ready, a feature branch can be merged back into master via a *pull request*
be merged back into master via a *merge request* in GitLab. in GitHub.
Before starting work on your feature, create a branch for it:: We assume you forked the Mutalyzer repository to your own namespace in GitHub
and are working from this fork. Before starting work on your feature, create a
branch for it::
git checkout -b your-feature git checkout -b your-feature
Commit changes on this branch. If you're happy with it, push to GitLab:: Commit changes on this branch. If you're happy with it, push to GitHub::
git push origin your-feature -u git push origin your-feature -u
Now create a merge request to discuss the implementation with your Now create a pull request to discuss the implementation with the Mutalyzer
colleagues. This might involve adding additional commits which are included in maintainers. This might involve adding additional commits which are included
the merge request by pushing your branch again:: in the pull request by pushing your branch again::
git commit git commit
git push git push
...@@ -79,7 +81,7 @@ changed since you started your work. This will require a forced push:: ...@@ -79,7 +81,7 @@ changed since you started your work. This will require a forced push::
git rebase origin/master git rebase origin/master
git push -f git push -f
If the work is done, a developer can merge your branch and close the merge If the work is done, a maintainer can merge your branch and close the pull
request. After the branch was merged you can safely delete it:: request. After the branch was merged you can safely delete it::
git branch -d your-feature git branch -d your-feature
...@@ -98,7 +100,7 @@ require X.Y.Z-dev instead of X.Y.Z.dev but `compatibility with setuptools ...@@ -98,7 +100,7 @@ require X.Y.Z-dev instead of X.Y.Z.dev but `compatibility with setuptools
is more important for us. Other than that, version semantics are as described is more important for us. Other than that, version semantics are as described
by SemVer. by SemVer.
Releases are available from the GitLab git repository as tags. Additionally, Releases are available from the GitHub git repository as tags. Additionally,
the latest release is available from the `release` branch. the latest release is available from the `release` branch.
.. note:: Older Mutalyzer version numbers took the form 2.0.beta-X where X was .. note:: Older Mutalyzer version numbers took the form 2.0.beta-X where X was
...@@ -127,11 +129,11 @@ Releasing a new version is done as follows: ...@@ -127,11 +129,11 @@ Releasing a new version is done as follows:
git commit -am 'Bump version to X.Y.Z' git commit -am 'Bump version to X.Y.Z'
git tag -a 'vX.Y.Z' git tag -a 'vX.Y.Z'
3. Push to the GitLab repository (assuming the remote name is `gitlab` and you 3. Push to the GitHub repository (assuming the remote name is `github` and you
are working on the `master` branch:: are working on the `master` branch::
git push gitlab master git push github master
git push gitlab master:release --tags git push github master:release --tags
4. Add a new entry at the top of the ``CHANGES`` file like this:: 4. Add a new entry at the top of the ``CHANGES`` file like this::
......
...@@ -5,11 +5,11 @@ ...@@ -5,11 +5,11 @@
Downloading Mutalyzer Downloading Mutalyzer
===================== =====================
The Mutalyzer source code is `hosted on the LUMC GitLab server The Mutalyzer source code is `hosted on GitHub
<https://git.lumc.nl/mutalyzer/mutalyzer>`_. The recommended way to get the <https://github.com/LUMC/mutalyzer>`_. The recommended way to get the
Mutalyzer source code is by cloning the `Git`_ repository:: Mutalyzer source code is by cloning the `Git`_ repository::
git clone https://git.lumc.nl/mutalyzer/mutalyzer.git git clone https://github.com/LUMC/mutalyzer.git
This will give you the current development version. See below for working with This will give you the current development version. See below for working with
other versions. other versions.
...@@ -34,9 +34,9 @@ Archive downloads ...@@ -34,9 +34,9 @@ Archive downloads
If for whatever reason you don't want to use Git, you can download the source If for whatever reason you don't want to use Git, you can download the source
code directly as a zip archive or tarball. The current development version can code directly as a zip archive or tarball. The current development version can
be found from the `project homepage be found from the `project homepage
<https://git.lumc.nl/mutalyzer/mutalyzer>`_. Archive downloads for release <https://github.com/LUMC/mutalyzer>`_. Archive downloads for release versions
versions can be found on the `tags page can be found on the `releases page
<https://git.lumc.nl/mutalyzer/mutalyzer/tags>`_. <https://github.com/LUMC/mutalyzer/releases>`_.
.. _Git: http://git-scm.com/ .. _Git: http://git-scm.com/
...@@ -5,13 +5,13 @@ For historical reasons, we currently have two issue trackers: ...@@ -5,13 +5,13 @@ For historical reasons, we currently have two issue trackers:
1. `Mutalyzer Trac -- Active tickets 1. `Mutalyzer Trac -- Active tickets
<https://humgenprojects.lumc.nl/trac/mutalyzer/report/2>`_ <https://humgenprojects.lumc.nl/trac/mutalyzer/report/2>`_
2. `Mutalyzer GitLab -- Open issues 2. `Mutalyzer GitHub -- Issues
<https://git.lumc.nl/mutalyzer/mutalyzer/issues>`_ <https://github.com/LUMC/mutalyzer/issues>`_
The first, on the Mutalyzer Trac website, is the advertised location for end The first, on the Mutalyzer Trac website, is the advertised location for end
users to report issues. This is also where most feature requests are tracked. users to report issues. This is also where most feature requests are tracked.
The second, on the Mutalyzer GitLab project site, is mainly for The second, on the Mutalyzer GitHub project site, is mainly for
developers. Most issues here are of infrastructural or technical nature. developers. Most issues here are of infrastructural or technical nature.
In addition to these issue lists, smaller and more specific notes can be found In addition to these issue lists, smaller and more specific notes can be found
......
...@@ -121,7 +121,7 @@ ...@@ -121,7 +121,7 @@
<a href="https://humgenprojects.lumc.nl/trac/mutalyzer" target="new">Feedback</a> <a href="https://humgenprojects.lumc.nl/trac/mutalyzer" target="new">Feedback</a>
</li> </li>
<li> <li>
<a href="https://git.lumc.nl/mutalyzer/mutalyzer" target="new">Source code</a> <a href="https://github.com/LUMC/mutalyzer" target="new">Source code</a>
</li> </li>
</ul> </ul>
</li> </li>
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment