arc/docs/pagure2gitlab/index.rst
Michal Konečný 1163aec0d6 Split the investigation to pagure and gitlab
This will help us to divide the work on the investigation more efficiently and
to work on separate documents regarding this investigation.

Signed-off-by: Michal Konečný <mkonecny@redhat.com>
2023-01-19 10:14:19 +01:00

67 lines
1.5 KiB
ReStructuredText

Pagure to Gitlab Importer
=========================
Purpose
-------
With Fedora and CentOS now having an official namespace on GitLab multiple projects wants to
migrate their repositories from `Pagure <https://pagure.io/>`_ to `GitLab <https://gitlab.com>`_.
This initiative is aimed to provide an easy way to migrate those projects.
Resources
---------
* Initiative proposal: https://pagure.io/cpe/initiatives-proposal/issue/25
* Pagure documentation: https://pagure.io/docs/pagure/
* GitLab documentation: https://docs.gitlab.com/
Requirements
------------
* Self-service tool
* Git commit history preservation
* Ability to migrate pagure issues
* Ability to migrate pull-requests
* Command line interface
* Ability to migrate files uploaded to PRs and issues
* Mapping of Fedora identity to GitLab users
* Tool should be usable by both CentOS and Fedora users
* Ability to access the correct namespace on GitLab
Nice to have
------------
List of features that would be nice to have.
* Web interface
* Syncing the FAS usernames to GitLab as users migrate for already migrated projects
Investigation
-------------
Following are the investigations of Pagure options to export the data and GitLab API investigation.
.. toctree::
:maxdepth: 1
pagure
gitlab
Conclusions
-----------
Conclusion for this initiative...
Proposed Roadmap
----------------
* Step 1 - Investigate Pagure2GitLab
* Step 2 - ???
* Step 3 - Profit!
Estimate of work
----------------
Estimation of work for this initiative...