Bug 1127056

Summary:	Migration Guide for community users
Product:	[Retired] Zanata	Reporter:	Michelle Kim <mkim>
Component:	Component-Docs	Assignee:	Carlos Munoz <camunoz>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Zanata-QA Mailling List <zanata-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	unspecified	CC:	camunoz, damason, djansen, noriko, zanata-bugs
Target Milestone:	---
Target Release:	3.6
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	2
Clone Of:		Environment:
Last Closed:	2015-03-19 07:10:27 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Michelle Kim 2014-08-06 03:52:55 UTC

We need a step by step guide to assist Package Maintainers / Engineers who wish to migrate their packages from different translation system to Zanata instance.

Some of the expected contents: 

How to pull pkgs from other instance
How to prepare files/dir for pushing to Zanata
GUI options
Command Line Client options 
How to pull the files and publish 
..etc

Comment 1 Isaac Rooskov 2014-08-20 01:32:26 UTC

https://fedoraproject.org/wiki/FAQ_on_migration_to_Transifex.com

https://phraseapp.com/docs/migration-guides/migrating-from-transifex-to-phraseapp

Comment 2 David Mason 2014-08-20 02:19:50 UTC

Create a maintainers' guide, somewhere in zanata.org/help

 - mention Zanata init (make sure server and client version that support this are available)
   - note that Zanata init will not work on F19. Using the ivy client may be a workaround for this.
 - example of single pot (gettext)
   - note that gettext projects have to use map-from to deal with Fedora locales that are using underscores.
 - example for multiple pot (podir)
 - point to zanata help docs for every step that is generic
   - update help docs for generic steps that are not up-to-date or good enough
   - add help page for zanata init
   - add some info to http://zanata.org/help/cli/cli-push/ about dealing specifically with gettext and podir directory structures
   - add page to  give an overview of the maintainer migration workflow  (“Maintainer Guide”)


Use this for guidance about the project structures we are likely to see in Fedora projects: https://fedoraproject.org/wiki/FAQ_on_migration_to_Transifex.com

Example of a migration guide: https://phraseapp.com/docs/migration-guides/migrating-from-transifex-to-phraseapp

Comment 3 Damian Jansen 2014-10-08 03:35:05 UTC

Verified