docs/initiatives.rst

@@ -9,6 +9,8 @@ Drafts
 .. toctree::
     :maxdepth: 1
 
+    pagure2gitlab/index
+
 Completed review
 ----------------
 .. toctree::

docs/pagure2gitlab/current_situation.rst

@@ -0,0 +1,7 @@
+.. _current_situation:
+
+Current situation
+=================
+
+This document describes investigation of what could be done with current state of GitLab API
+and Pagure API for purpose of the migration tool.

docs/pagure2gitlab/index.rst

@@ -0,0 +1,67 @@
+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 current situation and what are the possible solutions to
+met the requirements.
+
+.. toctree::
+    :maxdepth: 1
+
+    current_situation
+
+
+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...