Bug 1127056

Summary: Migration Guide for community users
Product: [Retired] Zanata Reporter: Michelle Kim <mkim>
Component: Component-DocsAssignee: Carlos Munoz <camunoz>
Status: CLOSED CURRENTRELEASE QA Contact: Zanata-QA Mailling List <zanata-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: unspecifiedCC: camunoz, damason, djansen, noriko, zanata-bugs
Target Milestone: ---   
Target Release: 3.6   
Hardware: Unspecified   
OS: Unspecified   
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:

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 

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