Bug 1127056 - Migration Guide for community users
Summary: Migration Guide for community users
Alias: None
Product: Zanata
Classification: Retired
Component: Component-Docs
Version: unspecified
Hardware: Unspecified
OS: Unspecified
Target Milestone: ---
: 3.6
Assignee: Carlos Munoz
QA Contact: Zanata-QA Mailling List
Depends On:
TreeView+ depends on / blocked
Reported: 2014-08-06 03:52 UTC by Michelle Kim
Modified: 2015-03-19 07:10 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: 2
Clone Of:
Last Closed: 2015-03-19 07:10:27 UTC

Attachments (Terms of Use)

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

Note You need to log in before you can comment on or make changes to this bug.