Support #36489

Create Git repositories for migrated documentation

Added by Francois Suter about 1 year ago. Updated about 1 year ago.

Status:Resolved Start date:2012-04-23
Priority:Should have Due date:2012-05-09
Assignee:Peter Niederlag % Done:

100%
Category:-
Target version:-
Votes: 1 (View)

Description

We are on the verge of migrating all official documentation from OpenOffice to reStructured Text. As part of this process we would like to move from SVN to Git. It is not necessary to import the existing data, nor history from the SVN repository. We just need new, empty Git repositories.

I have assembled a Google spreadsheet with the list of all existing extensions, their Forge project and the name we would like to have for the Git repositories, according to the naming conventions we adopted within the Documentation Team (we looked at existing projects; however should these names not fit, please inform us).

https://docs.google.com/spreadsheet/ccc?key=0AnHr9t2fgtVzdGpUaDNkZERiOGtydWpXdEJkTHBQaGc

The Forge project will give you the members for assigning the Git rights. The new FAL documentation does not have a project yet. I will open a separate support for it.

Related issues

related to forge.typo3.org - Support #36490: Create project for doc_core_fal Resolved 2012-04-23
related to git.typo3.org - Bug #36048: create a git repo instead of svn for new registered project New 2011-09-28 2012-07-05

History

#1
Updated by Steffen Gebert about 1 year ago

  • Assignee set to Steffen Gebert

Peter - time for your brand new "give me a git repo" script ;-)

#2
Updated by Steffen Gebert about 1 year ago

  • Assignee changed from Steffen Gebert to Peter Niederlag

#3
Updated by Fabien Udriot about 1 year ago

One SVN repository to be migrating to Git, that is not mentioned in the Google Spreadsheet from François, is the "book_extbase_fluid". It would be neat, if the history could be kept for this one.

Old SVN Repository:
https://svn.typo3.org/TYPO3v4/Documentation/book_extbase_fluid/trunk

New Git repository:
Documentation/TYPO3/Book/ExtbaseFluid.git

Forge Project:
http://forge.typo3.org/projects/book_extbase_fluid/

Thanks in advance.

#4
Updated by Francois Suter about 1 year ago

Any estimate about when we could hope to have the repos? Thanks.

#5
Updated by Peter Niederlag about 1 year ago

  • Due date set to 2012-05-09
  • Status changed from New to Accepted

#6
Updated by Francois Suter about 1 year ago

I don't want to seem too insistent, but we're actually waiting on these repositories to complete the migration of all the TYPO3 official documentation to reStructured Text. It's becoming quite a bottleneck. I know it's quite some work because it's not automated (AFAIK), but we really need these repos. Thanks in advance.

#7
Updated by Peter Niederlag about 1 year ago

  • Status changed from Accepted to Needs Feedback
  • % Done changed from 0 to 100

finally donedone.
let me know wether it works or you find any issues or anything missing.

fyi: i dont care for extension keys, i just need the forge_identifier(which is part of the url) and the git_path. ;)

thx, peter

#8
Updated by Francois Suter about 1 year ago

Peter, thanks a lot. It all looks good, except for the two following things:

  1. I spotted a small mistake, which actually comes from my Google spreadsheet (sorry): the repository Documentation/TYPO3/Guide/FrontedLocalization.git should be Documentation/TYPO3/Guide/FrontendLocalization.git (there's a "n" missing in "Frontend"). Is it possible to rename it?
  2. there's no repository for the File Abstraction Layer manual. Is that because you need the Forge project first? The problem is that I can't create the Forge project, because it's supposed to be a sub-project of "Official documentation" and creating sub-project is bugged. I have opened an issue about this: http://forge.typo3.org/issues/36490. Can you maybe do something about this too?

#9
Updated by Chris topher about 1 year ago

Thanks, Peter!

Additionally to what Francois noted above:

3. Forge project: project:typo3v4-doc_guide_admin
Git repo: Documentation/TYPO3/Guide/Administrators.git

4. Forge project: Official Doc Extension Template
Git repo: TYPO3v4/Extensions/doc_template.git

5. Forge project: Indexed Search
Git repo: Documentation/TYPO3/Reference/IndexedSearch.git

6. Please create a new Git repository for Fabien's book: Documentation/TYPO3/Book/ExtbaseFluid.git
See http://forge.typo3.org/issues/36489#note-3

Sorry for coming a bit late with these notes.

#10
Updated by Peter Niederlag about 1 year ago

spelling of Documentation/TYPO3/Guide/FrontendLocalization.git has been fixed

#11
Updated by Peter Niederlag about 1 year ago

  • % Done changed from 100 to 90

3., 4. and 5 have been created properly.

for svn to git migration I'd like to collect proper svn user to git author information:

fab1en
dasoe
mheiger
michadu
d.m.
mgoldbeck
franzripfel (done)

well, maybe I'll just ignore that. ;)

#12
Updated by Peter Niederlag about 1 year ago

  • Status changed from Needs Feedback to Resolved
  • % Done changed from 90 to 100

now imported 6.) without mapping the usernames.

#13
Updated by Francois Suter about 1 year ago

It all looks good, thanks a lot Peter.

#14
Updated by Francois Suter about 1 year ago

Peter, I need to add Fabien Udriot (fudriot) as a committer to Documentation/TYPO3/Example/Manual.git. I have added him as a member of the corresponding Forge project (http://forge.typo3.org/projects/show/typo3v4-official_template), but I don't think that this is sync'ed automatically, is it? Could you add him then, please? Is there any plan to automate Forge member management with Git/Gerrit rights?

#15
Updated by Steffen Gebert about 1 year ago

They're synced every 30 minutes.

#16
Updated by Francois Suter about 1 year ago

Oh great, I didn't know. Wonderful!

Also available in: Atom PDF