SlideShare uma empresa Scribd logo
1 de 32
Baixar para ler offline
The OpenStack Summit
San Diago 2012




                       OpenStack Documentation and
                         Translation Management


                        Ying Chun Guo (Daisy)       Anne Gentle
                       OpenStack Doc Team       OpenStack Doc Team
                       guoyingc@cn.ibm.com      anne@openstack.org




                                                                     © 2009 IBM Corporation
Agenda


            Status of OpenStack Document


            Translation Management & Process


            Samples of Translation Process


            Plans for next steps


            Questions with Answers




www.openstack.org                              2
Agenda


            Status of OpenStack Document


            Translation Management & Process


            Samples of Translation Process


            Plans for next steps

            Questions with Answers




www.openstack.org                              3
文档页面
                    Web Page for Documentation

       http://docs.openstack.org




www.openstack.org
Challenges of Community Document

       Large amount of code       Grow quickly


       Change frequently          Loose coupling


             Manage document as code !




www.openstack.org                                      5
Document Process: Design

       Blueprints and discussion at Design Summit

       Blueprints

       Current blueprints found at
       https://blueprints.launchpad.net/openstack-manuals




www.openstack.org                                           6
Document Process : Development

       Github repositories store admin guides and API
       guides

       Unit tests with Jenkins

       Patch review with Gerrit




www.openstack.org                                       7
Document Process : Bug tracking

       Manage bugs through Lanuchpad
         Bug logging
         Bug triaging
         Bug assigning




www.openstack.org                                     8
Document Process : Publishing

       Automatically publish with Jenkins




www.openstack.org                                   9
Doc Team Composition

       All OpenStack community members

       One percenters = OpenStack-doc-core

       Badge Wearers
         AT&T
         IBM
         Nebula
         Nicira
         Nimbis Services
         Nuage
         Rackspace
         RedHat




www.openstack.org                            10
Statics

       20+ Compute Extensions documented at api.openstack.org

       66% Site visitors stay instead of leaving

       100 Doc patches and reviews a month

       726 Configuration options : 467 for nova.conf, 259 for swift conf
       files

       10,000 Unique visitors a week at docs.openstack.org




www.openstack.org                                                          11
Agenda


            Status of OpenStack Document


            Translation Management & Process


            Samples of Translation Process


            Plans for next steps

            Questions with Answers




www.openstack.org                              12
Challenges of Document Translation

       Large amount of code          Grow quickly

       Change frequently             Loose coupling


        Manage document translation as code string translation!




www.openstack.org                                                 13
Translation Process : Slicing


       Slice DocBook into string segment with a Python script, and
       generate a PO template

                ./tools/generatepot openstack-compute-admin




www.openstack.org                                                    14
Translation Process : Translating

       Manage translation by Transifex
         Translation project & resources
         Translation memory
         Glossary




www.openstack.org                                       15
Translation Process : Merging


       Merge the translated string into Docbook with a python script.

       ./tools/generatedocbook -l zh_CN -b openstack-compute-admin




www.openstack.org                                                       16
Translation Process : Uploading & Downloading


       Upload the translation resources and download the translated
       results by commands of Transifex Client.

       tx set --auto-local -r openstack-manuals-i18n.openstack-api-
       programming 'doc/src/docbkx/openstack-api-
       programming/locale/<lang>.po' --source-lang en --source-file
       doc/src/docbkx/openstack-api-programming/locale/openstack-api-
       programming.pot –execute

       tx pull -f -l zh_CN -r openstack-manuals-i18n.api-quick-start

       tx push -s -r openstack-manuals-i18n.api-quick-start




www.openstack.org                                                       17
Translation Process : Change Management


       Synchronize the local translation resources with the resources in
       the Transifex server by Transifex Client commands.

       Command “tx push” will automatically check the differences and
       merge the local copy and remote copy.
         New strings will be added.
         Modified strings will be considered new ones and added as well.
         Strings which do not exist in the new source file (including ones which
         have been modified) will be removed from the database.
         The removed translations are kept in the Translation Memory of your
         project.

  ./tools/generatedocbook -l zh_CN -b openstack-manuals-i18n.api-quick-
       start

  tx push -s -r openstack-manuals-i18n.api-quick-start

  tx pull -r openstack-manuals-i18n.api-quick-start


www.openstack.org                                                                  18
Statics

       5 languages translation started
         Chinese – 11%, Spanish – 5%, Czech – 3%, Korean, French

       15+ translators contributed.

       Chinese translations
         “OpenStack API Quick Start” 100% finished
         “Network Administration Guide” 59% finished
         “OpenStack Install and Deploy Manual” 44% finished




www.openstack.org                                                  19
Agenda


            Status of OpenStack Document


            Translation Management & Process


            Samples of Translation Process


            Plans for next steps

            Questions with Answers




www.openstack.org                              20
Sample : Chinese Document Generation

       Step 1: Check out the sources from Git repository
         git clone https://github.com/daisy-ycguo/openstack-manuals-i18n.git




       Step 2: Check out the latest translation from Transifex
         tx pull -f -l zh_CN -r openstack-manuals-i18n.api-quick-start




www.openstack.org                                                              21
Sample : Chinese Document Generation

       Step 3: Merge the translation segments back to DocBook
         ./tools/generatedocbook -l zh_CN -b api-quick-start




       Step 4: Generate PDF and HTML document
         mvn generate-sources




www.openstack.org
Agenda


            Status of OpenStack Document


            Translation Management & Process


            Samples of Translation Process


            Plans for next steps

            Questions with Answers




www.openstack.org                              23
Plans for next steps

       Integrate the process into Continuous Integration system.
         Slicing & uploading
         Downloading
         Merging & publishing to website automatically
         Updating

       Resolve the issue: lack of translation context after slicing into
       statements.
         Using a website to show the up-to-date translated documents, to facilitate
         the translators to check their translation results at any time.



        Any kinds of contributions to translation process is warmly welcomed !




www.openstack.org
Agenda


            Status of OpenStack Document


            Translation Management & Process


            Samples of Translation Process


            Plans for next steps

            Questions with Answers




www.openstack.org                              25
How can I get on the openstack-core-docs team?


       Do lots of reviews at http://review.openstack.org for the openstack-
       manuals project.

       Triage bugs and log doc bugs at
       http://bugs.launchpad.net/openstack-manuals.

       We’ll discuss on the openstack-docs-core mailing list and then invite
       you.




www.openstack.org                                                         26
How should I find doc work that needs to be
                    done on a particular project?


       Refer to http://bugs.launchpad.net/openstack-manuals and look for
       Wishlist for tasks, or any doc bug can be picked up as a work item.

       We also track few blueprints which may need someone to work on,
       though doc bugs are probably the best first place to look




www.openstack.org                                                        27
Who should do reviews of my document
                    changes?


       Anne Gentle, the doc coordinator, or anyone on the openstack-doc-
       core team can help you identify reviewers, or you can also check
       the doc bug and ask the reporter to review the changes by adding
       their name to the reviewers list.




www.openstack.org                                                      28
How to contribute the translations ?


       If you want to contribute the translations, you need to register an
       account at Transifex, and then go to openstack-manuals translation
       page.

       After that, select the languages you prefer, all of the language
       resources will be listed. Then select the resources you want to work
       on and click it. Click “Translate Now” in the pop-up dialog.




www.openstack.org                                                        29
How to get the latest translation documents ?


       Check out the latest resources from Git repository at first, and then
       check out the latest translation from Transifex. After that, merge
       the translation segment back to DocBook by running the Python
       script and generate PDF and HTML document by running Maven
       build.

       Refer to “Sample: Chinese Document Generation”




www.openstack.org                                                          30
Conclusion

       Managing document as code is key feature of OpenStack
       documentation.

       The translation is just started. I will need the support and
       participation from all of you.

       Your participation is warmly welcomed.

       For any problems about documentation, please contact with Anne
       Gentle.

       For any problems about translation, please contact with Ying Chun
       Guo.




www.openstack.org                                                       31
Reference
       Documentation page
         http://docs.openstack.org

       Blueprints of documents
         https://blueprints.launchpad.net/ openstack-manuals

       Bugs of documents
         http://bugs.launchpad.net/openstack-manuals

       Main page for openstack-manuals translation in Transifex
         https://www.transifex.net/projects/p/openstack-manuals-i18n/

       OpenStack Document Translation Guide
         https://gist.github.com/3037139

       Address of Chinese Openstack manuals (as temporary)
         http://1.openstackcn.sinaapp.com/?page_id=8




www.openstack.org

Mais conteúdo relacionado

Mais procurados

Becoming a Plumber: Building Deployment Pipelines - RevConf
Becoming a Plumber: Building Deployment Pipelines - RevConfBecoming a Plumber: Building Deployment Pipelines - RevConf
Becoming a Plumber: Building Deployment Pipelines - RevConfDaniel Barker
 
FASTEN: Scaling static analyses to ecosystem, presented at FOSDEM 2020 in Bru...
FASTEN: Scaling static analyses to ecosystem, presented at FOSDEM 2020 in Bru...FASTEN: Scaling static analyses to ecosystem, presented at FOSDEM 2020 in Bru...
FASTEN: Scaling static analyses to ecosystem, presented at FOSDEM 2020 in Bru...Fasten Project
 
Nobody Knows What It’s Like To Be the Bad Man: The Development Process for th...
Nobody Knows What It’s Like To Be the Bad Man: The Development Process for th...Nobody Knows What It’s Like To Be the Bad Man: The Development Process for th...
Nobody Knows What It’s Like To Be the Bad Man: The Development Process for th...Work-Bench
 
Reproducibility with Checkpoint & RRO
Reproducibility with Checkpoint & RROReproducibility with Checkpoint & RRO
Reproducibility with Checkpoint & RROWork-Bench
 
An introduction to git
An introduction to gitAn introduction to git
An introduction to gitolberger
 
Kernel Recipes 2016 - Patches carved into stone tablets...
Kernel Recipes 2016 - Patches carved into stone tablets...Kernel Recipes 2016 - Patches carved into stone tablets...
Kernel Recipes 2016 - Patches carved into stone tablets...Anne Nicolas
 
JavaOne 2016 - Pipeline as code
JavaOne 2016 - Pipeline as codeJavaOne 2016 - Pipeline as code
JavaOne 2016 - Pipeline as codeBert Jan Schrijver
 
HTTP2 in action - Piet Van Dongen - Codemotion Amsterdam 2017
HTTP2 in action - Piet Van Dongen - Codemotion Amsterdam 2017HTTP2 in action - Piet Van Dongen - Codemotion Amsterdam 2017
HTTP2 in action - Piet Van Dongen - Codemotion Amsterdam 2017Codemotion
 
Becoming A Plumber: Building Deployment Pipelines - LISA17
Becoming A Plumber: Building Deployment Pipelines - LISA17Becoming A Plumber: Building Deployment Pipelines - LISA17
Becoming A Plumber: Building Deployment Pipelines - LISA17Daniel Barker
 
Voxxed Luxembourd 2016 Jenkins 2.0 et Pipeline as code
Voxxed Luxembourd 2016 Jenkins 2.0 et Pipeline as codeVoxxed Luxembourd 2016 Jenkins 2.0 et Pipeline as code
Voxxed Luxembourd 2016 Jenkins 2.0 et Pipeline as codeDamien Duportal
 
[KubeCon NA 2018] Effective Kubernetes Develop: Turbocharge Your Dev Loop - P...
[KubeCon NA 2018] Effective Kubernetes Develop: Turbocharge Your Dev Loop - P...[KubeCon NA 2018] Effective Kubernetes Develop: Turbocharge Your Dev Loop - P...
[KubeCon NA 2018] Effective Kubernetes Develop: Turbocharge Your Dev Loop - P...Ambassador Labs
 
Pipeline as code - new feature in Jenkins 2
Pipeline as code - new feature in Jenkins 2Pipeline as code - new feature in Jenkins 2
Pipeline as code - new feature in Jenkins 2Michal Ziarnik
 
Bgoug 2019.11 test your pl sql - not your patience
Bgoug 2019.11   test your pl sql - not your patienceBgoug 2019.11   test your pl sql - not your patience
Bgoug 2019.11 test your pl sql - not your patienceJacek Gebal
 
Becoming a Plumber: Building Deployment Pipelines - All Day DevOps
Becoming a Plumber: Building Deployment Pipelines - All Day DevOpsBecoming a Plumber: Building Deployment Pipelines - All Day DevOps
Becoming a Plumber: Building Deployment Pipelines - All Day DevOpsDaniel Barker
 
Pipeline based deployments on Jenkins
Pipeline based deployments  on JenkinsPipeline based deployments  on Jenkins
Pipeline based deployments on JenkinsKnoldus Inc.
 
Building an Extensible, Resumable DSL on Top of Apache Groovy
Building an Extensible, Resumable DSL on Top of Apache GroovyBuilding an Extensible, Resumable DSL on Top of Apache Groovy
Building an Extensible, Resumable DSL on Top of Apache Groovyjgcloudbees
 
Jfokus 2017 - The DevOps Disaster
Jfokus 2017 - The DevOps Disaster Jfokus 2017 - The DevOps Disaster
Jfokus 2017 - The DevOps Disaster Bert Jan Schrijver
 

Mais procurados (19)

Becoming a Plumber: Building Deployment Pipelines - RevConf
Becoming a Plumber: Building Deployment Pipelines - RevConfBecoming a Plumber: Building Deployment Pipelines - RevConf
Becoming a Plumber: Building Deployment Pipelines - RevConf
 
FASTEN: Scaling static analyses to ecosystem, presented at FOSDEM 2020 in Bru...
FASTEN: Scaling static analyses to ecosystem, presented at FOSDEM 2020 in Bru...FASTEN: Scaling static analyses to ecosystem, presented at FOSDEM 2020 in Bru...
FASTEN: Scaling static analyses to ecosystem, presented at FOSDEM 2020 in Bru...
 
Nobody Knows What It’s Like To Be the Bad Man: The Development Process for th...
Nobody Knows What It’s Like To Be the Bad Man: The Development Process for th...Nobody Knows What It’s Like To Be the Bad Man: The Development Process for th...
Nobody Knows What It’s Like To Be the Bad Man: The Development Process for th...
 
Reproducibility with Checkpoint & RRO
Reproducibility with Checkpoint & RROReproducibility with Checkpoint & RRO
Reproducibility with Checkpoint & RRO
 
An introduction to git
An introduction to gitAn introduction to git
An introduction to git
 
Kernel Recipes 2016 - Patches carved into stone tablets...
Kernel Recipes 2016 - Patches carved into stone tablets...Kernel Recipes 2016 - Patches carved into stone tablets...
Kernel Recipes 2016 - Patches carved into stone tablets...
 
JavaOne 2016 - Pipeline as code
JavaOne 2016 - Pipeline as codeJavaOne 2016 - Pipeline as code
JavaOne 2016 - Pipeline as code
 
Jenkins Pipelines
Jenkins PipelinesJenkins Pipelines
Jenkins Pipelines
 
HTTP2 in action - Piet Van Dongen - Codemotion Amsterdam 2017
HTTP2 in action - Piet Van Dongen - Codemotion Amsterdam 2017HTTP2 in action - Piet Van Dongen - Codemotion Amsterdam 2017
HTTP2 in action - Piet Van Dongen - Codemotion Amsterdam 2017
 
Becoming A Plumber: Building Deployment Pipelines - LISA17
Becoming A Plumber: Building Deployment Pipelines - LISA17Becoming A Plumber: Building Deployment Pipelines - LISA17
Becoming A Plumber: Building Deployment Pipelines - LISA17
 
Voxxed Luxembourd 2016 Jenkins 2.0 et Pipeline as code
Voxxed Luxembourd 2016 Jenkins 2.0 et Pipeline as codeVoxxed Luxembourd 2016 Jenkins 2.0 et Pipeline as code
Voxxed Luxembourd 2016 Jenkins 2.0 et Pipeline as code
 
Hotsos Advanced Linux Tools
Hotsos Advanced Linux ToolsHotsos Advanced Linux Tools
Hotsos Advanced Linux Tools
 
[KubeCon NA 2018] Effective Kubernetes Develop: Turbocharge Your Dev Loop - P...
[KubeCon NA 2018] Effective Kubernetes Develop: Turbocharge Your Dev Loop - P...[KubeCon NA 2018] Effective Kubernetes Develop: Turbocharge Your Dev Loop - P...
[KubeCon NA 2018] Effective Kubernetes Develop: Turbocharge Your Dev Loop - P...
 
Pipeline as code - new feature in Jenkins 2
Pipeline as code - new feature in Jenkins 2Pipeline as code - new feature in Jenkins 2
Pipeline as code - new feature in Jenkins 2
 
Bgoug 2019.11 test your pl sql - not your patience
Bgoug 2019.11   test your pl sql - not your patienceBgoug 2019.11   test your pl sql - not your patience
Bgoug 2019.11 test your pl sql - not your patience
 
Becoming a Plumber: Building Deployment Pipelines - All Day DevOps
Becoming a Plumber: Building Deployment Pipelines - All Day DevOpsBecoming a Plumber: Building Deployment Pipelines - All Day DevOps
Becoming a Plumber: Building Deployment Pipelines - All Day DevOps
 
Pipeline based deployments on Jenkins
Pipeline based deployments  on JenkinsPipeline based deployments  on Jenkins
Pipeline based deployments on Jenkins
 
Building an Extensible, Resumable DSL on Top of Apache Groovy
Building an Extensible, Resumable DSL on Top of Apache GroovyBuilding an Extensible, Resumable DSL on Top of Apache Groovy
Building an Extensible, Resumable DSL on Top of Apache Groovy
 
Jfokus 2017 - The DevOps Disaster
Jfokus 2017 - The DevOps Disaster Jfokus 2017 - The DevOps Disaster
Jfokus 2017 - The DevOps Disaster
 

Semelhante a OpenStack documentation & translation management 2012_summit

OpenStack Documentation Projects and Processes
OpenStack Documentation Projects and ProcessesOpenStack Documentation Projects and Processes
OpenStack Documentation Projects and ProcessesAnne Gentle
 
Integração contínua com Jenkins
Integração contínua com JenkinsIntegração contínua com Jenkins
Integração contínua com JenkinsAécio Pires
 
OpenStack Documentation in the Open
OpenStack Documentation in the OpenOpenStack Documentation in the Open
OpenStack Documentation in the OpenAnne Gentle
 
Openshift cheat rhce_r3v1 rhce
Openshift cheat rhce_r3v1 rhceOpenshift cheat rhce_r3v1 rhce
Openshift cheat rhce_r3v1 rhceDarnette A
 
Apache Deep Learning 101 - ApacheCon Montreal 2018 v0.31
Apache Deep Learning 101 - ApacheCon Montreal 2018 v0.31Apache Deep Learning 101 - ApacheCon Montreal 2018 v0.31
Apache Deep Learning 101 - ApacheCon Montreal 2018 v0.31Timothy Spann
 
Weekly lecture appsterdam_19mar2014
Weekly lecture appsterdam_19mar2014Weekly lecture appsterdam_19mar2014
Weekly lecture appsterdam_19mar2014Microsoft
 
Building and deploying LLM applications with Apache Airflow
Building and deploying LLM applications with Apache AirflowBuilding and deploying LLM applications with Apache Airflow
Building and deploying LLM applications with Apache AirflowKaxil Naik
 
ApacheCon 2021: Apache NiFi 101- introduction and best practices
ApacheCon 2021:   Apache NiFi 101- introduction and best practicesApacheCon 2021:   Apache NiFi 101- introduction and best practices
ApacheCon 2021: Apache NiFi 101- introduction and best practicesTimothy Spann
 
ApacheCon 2021 - Apache NiFi Deep Dive 300
ApacheCon 2021 - Apache NiFi Deep Dive 300ApacheCon 2021 - Apache NiFi Deep Dive 300
ApacheCon 2021 - Apache NiFi Deep Dive 300Timothy Spann
 
FireWorks overview
FireWorks overviewFireWorks overview
FireWorks overviewAnubhav Jain
 
Introduction about Full stack Development
Introduction about Full stack DevelopmentIntroduction about Full stack Development
Introduction about Full stack Developmentrajasekarandpm
 
Docker Platform and Ecosystem Nov 2015
Docker Platform and Ecosystem Nov 2015Docker Platform and Ecosystem Nov 2015
Docker Platform and Ecosystem Nov 2015Patrick Chanezon
 
Being Ready for Apache Kafka - Apache: Big Data Europe 2015
Being Ready for Apache Kafka - Apache: Big Data Europe 2015Being Ready for Apache Kafka - Apache: Big Data Europe 2015
Being Ready for Apache Kafka - Apache: Big Data Europe 2015Michael Noll
 
End-to-End ML pipelines with Beam, Flink, TensorFlow and Hopsworks.
End-to-End ML pipelines with Beam, Flink, TensorFlow and Hopsworks.End-to-End ML pipelines with Beam, Flink, TensorFlow and Hopsworks.
End-to-End ML pipelines with Beam, Flink, TensorFlow and Hopsworks.Theofilos Kakantousis
 
Make an Instant Website with Webhooks
Make an Instant Website with WebhooksMake an Instant Website with Webhooks
Make an Instant Website with WebhooksAnne Gentle
 
Open Source tools overview
Open Source tools overviewOpen Source tools overview
Open Source tools overviewLuciano Resende
 
A DevOps guide to Kubernetes
A DevOps guide to KubernetesA DevOps guide to Kubernetes
A DevOps guide to KubernetesPaul Czarkowski
 
Big Data Open Source Security LLC: Realtime log analysis with Mesos, Docker, ...
Big Data Open Source Security LLC: Realtime log analysis with Mesos, Docker, ...Big Data Open Source Security LLC: Realtime log analysis with Mesos, Docker, ...
Big Data Open Source Security LLC: Realtime log analysis with Mesos, Docker, ...DataStax Academy
 
CAPS: What's best for deploying and managing OpenStack? Chef vs. Ansible vs. ...
CAPS: What's best for deploying and managing OpenStack? Chef vs. Ansible vs. ...CAPS: What's best for deploying and managing OpenStack? Chef vs. Ansible vs. ...
CAPS: What's best for deploying and managing OpenStack? Chef vs. Ansible vs. ...Daniel Krook
 

Semelhante a OpenStack documentation & translation management 2012_summit (20)

OpenStack Documentation Projects and Processes
OpenStack Documentation Projects and ProcessesOpenStack Documentation Projects and Processes
OpenStack Documentation Projects and Processes
 
Integração contínua com Jenkins
Integração contínua com JenkinsIntegração contínua com Jenkins
Integração contínua com Jenkins
 
OpenStack Documentation in the Open
OpenStack Documentation in the OpenOpenStack Documentation in the Open
OpenStack Documentation in the Open
 
Openshift cheat rhce_r3v1 rhce
Openshift cheat rhce_r3v1 rhceOpenshift cheat rhce_r3v1 rhce
Openshift cheat rhce_r3v1 rhce
 
Apache Deep Learning 101 - ApacheCon Montreal 2018 v0.31
Apache Deep Learning 101 - ApacheCon Montreal 2018 v0.31Apache Deep Learning 101 - ApacheCon Montreal 2018 v0.31
Apache Deep Learning 101 - ApacheCon Montreal 2018 v0.31
 
Weekly lecture appsterdam_19mar2014
Weekly lecture appsterdam_19mar2014Weekly lecture appsterdam_19mar2014
Weekly lecture appsterdam_19mar2014
 
Building and deploying LLM applications with Apache Airflow
Building and deploying LLM applications with Apache AirflowBuilding and deploying LLM applications with Apache Airflow
Building and deploying LLM applications with Apache Airflow
 
ApacheCon 2021: Apache NiFi 101- introduction and best practices
ApacheCon 2021:   Apache NiFi 101- introduction and best practicesApacheCon 2021:   Apache NiFi 101- introduction and best practices
ApacheCon 2021: Apache NiFi 101- introduction and best practices
 
Apache Deep Learning 201
Apache Deep Learning 201Apache Deep Learning 201
Apache Deep Learning 201
 
ApacheCon 2021 - Apache NiFi Deep Dive 300
ApacheCon 2021 - Apache NiFi Deep Dive 300ApacheCon 2021 - Apache NiFi Deep Dive 300
ApacheCon 2021 - Apache NiFi Deep Dive 300
 
FireWorks overview
FireWorks overviewFireWorks overview
FireWorks overview
 
Introduction about Full stack Development
Introduction about Full stack DevelopmentIntroduction about Full stack Development
Introduction about Full stack Development
 
Docker Platform and Ecosystem Nov 2015
Docker Platform and Ecosystem Nov 2015Docker Platform and Ecosystem Nov 2015
Docker Platform and Ecosystem Nov 2015
 
Being Ready for Apache Kafka - Apache: Big Data Europe 2015
Being Ready for Apache Kafka - Apache: Big Data Europe 2015Being Ready for Apache Kafka - Apache: Big Data Europe 2015
Being Ready for Apache Kafka - Apache: Big Data Europe 2015
 
End-to-End ML pipelines with Beam, Flink, TensorFlow and Hopsworks.
End-to-End ML pipelines with Beam, Flink, TensorFlow and Hopsworks.End-to-End ML pipelines with Beam, Flink, TensorFlow and Hopsworks.
End-to-End ML pipelines with Beam, Flink, TensorFlow and Hopsworks.
 
Make an Instant Website with Webhooks
Make an Instant Website with WebhooksMake an Instant Website with Webhooks
Make an Instant Website with Webhooks
 
Open Source tools overview
Open Source tools overviewOpen Source tools overview
Open Source tools overview
 
A DevOps guide to Kubernetes
A DevOps guide to KubernetesA DevOps guide to Kubernetes
A DevOps guide to Kubernetes
 
Big Data Open Source Security LLC: Realtime log analysis with Mesos, Docker, ...
Big Data Open Source Security LLC: Realtime log analysis with Mesos, Docker, ...Big Data Open Source Security LLC: Realtime log analysis with Mesos, Docker, ...
Big Data Open Source Security LLC: Realtime log analysis with Mesos, Docker, ...
 
CAPS: What's best for deploying and managing OpenStack? Chef vs. Ansible vs. ...
CAPS: What's best for deploying and managing OpenStack? Chef vs. Ansible vs. ...CAPS: What's best for deploying and managing OpenStack? Chef vs. Ansible vs. ...
CAPS: What's best for deploying and managing OpenStack? Chef vs. Ansible vs. ...
 

Mais de Anne Gentle

Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Inclusive, Accessible Tech: Bias-Free Language in Code and ConfigurationsInclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Inclusive, Accessible Tech: Bias-Free Language in Code and ConfigurationsAnne Gentle
 
Docs as Code: Publishing Processes for API Experiences
Docs as Code: Publishing Processes for API ExperiencesDocs as Code: Publishing Processes for API Experiences
Docs as Code: Publishing Processes for API ExperiencesAnne Gentle
 
Docs Like Code: Strategies and Stories
Docs Like Code: Strategies and StoriesDocs Like Code: Strategies and Stories
Docs Like Code: Strategies and StoriesAnne Gentle
 
Deploying Apps on OpenStack
Deploying Apps on OpenStackDeploying Apps on OpenStack
Deploying Apps on OpenStackAnne Gentle
 
Collaborating on GitHub for Open Source Documentation
Collaborating on GitHub for Open Source DocumentationCollaborating on GitHub for Open Source Documentation
Collaborating on GitHub for Open Source DocumentationAnne Gentle
 
Journey into Continuous Glucose Monitoring Technology as a Parent
Journey into Continuous Glucose Monitoring Technology as a ParentJourney into Continuous Glucose Monitoring Technology as a Parent
Journey into Continuous Glucose Monitoring Technology as a ParentAnne Gentle
 
Collaborating on GitHub for Open Source Documentation
Collaborating on GitHub for Open Source DocumentationCollaborating on GitHub for Open Source Documentation
Collaborating on GitHub for Open Source DocumentationAnne Gentle
 
Git and GitHub for Documentation
Git and GitHub for DocumentationGit and GitHub for Documentation
Git and GitHub for DocumentationAnne Gentle
 
Writing a Technical Talk Proposal
Writing a Technical Talk ProposalWriting a Technical Talk Proposal
Writing a Technical Talk ProposalAnne Gentle
 
Women in tech: Be that light
Women in tech: Be that lightWomen in tech: Be that light
Women in tech: Be that lightAnne Gentle
 
You'll Never Look at Developer Support the Same Way Again
You'll Never Look at Developer Support the Same Way AgainYou'll Never Look at Developer Support the Same Way Again
You'll Never Look at Developer Support the Same Way AgainAnne Gentle
 
So You Want to be an OpenStack Contributor
So You Want to be an OpenStack ContributorSo You Want to be an OpenStack Contributor
So You Want to be an OpenStack ContributorAnne Gentle
 
OpenStack Doc Overview for Boot Camp
OpenStack Doc Overview for Boot CampOpenStack Doc Overview for Boot Camp
OpenStack Doc Overview for Boot CampAnne Gentle
 
Social Media, Social Networking, and Social Relevance in Tech Comm
Social Media, Social Networking, and Social Relevance in Tech CommSocial Media, Social Networking, and Social Relevance in Tech Comm
Social Media, Social Networking, and Social Relevance in Tech CommAnne Gentle
 
OpenStack How To - PyLadies ATX
OpenStack How To - PyLadies ATXOpenStack How To - PyLadies ATX
OpenStack How To - PyLadies ATXAnne Gentle
 
Women of OpenStack breakfast welcome
Women of OpenStack breakfast welcomeWomen of OpenStack breakfast welcome
Women of OpenStack breakfast welcomeAnne Gentle
 
Social web for Tech Comm, STC March 2013
Social web for Tech Comm, STC March 2013Social web for Tech Comm, STC March 2013
Social web for Tech Comm, STC March 2013Anne Gentle
 
TryStack: A Sandbox for OpenStack Users and Admins
TryStack: A Sandbox for OpenStack Users and AdminsTryStack: A Sandbox for OpenStack Users and Admins
TryStack: A Sandbox for OpenStack Users and AdminsAnne Gentle
 
Sprints and Stacks
Sprints and StacksSprints and Stacks
Sprints and StacksAnne Gentle
 

Mais de Anne Gentle (20)

Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Inclusive, Accessible Tech: Bias-Free Language in Code and ConfigurationsInclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations
 
Docs as Code: Publishing Processes for API Experiences
Docs as Code: Publishing Processes for API ExperiencesDocs as Code: Publishing Processes for API Experiences
Docs as Code: Publishing Processes for API Experiences
 
Docs Like Code
Docs Like CodeDocs Like Code
Docs Like Code
 
Docs Like Code: Strategies and Stories
Docs Like Code: Strategies and StoriesDocs Like Code: Strategies and Stories
Docs Like Code: Strategies and Stories
 
Deploying Apps on OpenStack
Deploying Apps on OpenStackDeploying Apps on OpenStack
Deploying Apps on OpenStack
 
Collaborating on GitHub for Open Source Documentation
Collaborating on GitHub for Open Source DocumentationCollaborating on GitHub for Open Source Documentation
Collaborating on GitHub for Open Source Documentation
 
Journey into Continuous Glucose Monitoring Technology as a Parent
Journey into Continuous Glucose Monitoring Technology as a ParentJourney into Continuous Glucose Monitoring Technology as a Parent
Journey into Continuous Glucose Monitoring Technology as a Parent
 
Collaborating on GitHub for Open Source Documentation
Collaborating on GitHub for Open Source DocumentationCollaborating on GitHub for Open Source Documentation
Collaborating on GitHub for Open Source Documentation
 
Git and GitHub for Documentation
Git and GitHub for DocumentationGit and GitHub for Documentation
Git and GitHub for Documentation
 
Writing a Technical Talk Proposal
Writing a Technical Talk ProposalWriting a Technical Talk Proposal
Writing a Technical Talk Proposal
 
Women in tech: Be that light
Women in tech: Be that lightWomen in tech: Be that light
Women in tech: Be that light
 
You'll Never Look at Developer Support the Same Way Again
You'll Never Look at Developer Support the Same Way AgainYou'll Never Look at Developer Support the Same Way Again
You'll Never Look at Developer Support the Same Way Again
 
So You Want to be an OpenStack Contributor
So You Want to be an OpenStack ContributorSo You Want to be an OpenStack Contributor
So You Want to be an OpenStack Contributor
 
OpenStack Doc Overview for Boot Camp
OpenStack Doc Overview for Boot CampOpenStack Doc Overview for Boot Camp
OpenStack Doc Overview for Boot Camp
 
Social Media, Social Networking, and Social Relevance in Tech Comm
Social Media, Social Networking, and Social Relevance in Tech CommSocial Media, Social Networking, and Social Relevance in Tech Comm
Social Media, Social Networking, and Social Relevance in Tech Comm
 
OpenStack How To - PyLadies ATX
OpenStack How To - PyLadies ATXOpenStack How To - PyLadies ATX
OpenStack How To - PyLadies ATX
 
Women of OpenStack breakfast welcome
Women of OpenStack breakfast welcomeWomen of OpenStack breakfast welcome
Women of OpenStack breakfast welcome
 
Social web for Tech Comm, STC March 2013
Social web for Tech Comm, STC March 2013Social web for Tech Comm, STC March 2013
Social web for Tech Comm, STC March 2013
 
TryStack: A Sandbox for OpenStack Users and Admins
TryStack: A Sandbox for OpenStack Users and AdminsTryStack: A Sandbox for OpenStack Users and Admins
TryStack: A Sandbox for OpenStack Users and Admins
 
Sprints and Stacks
Sprints and StacksSprints and Stacks
Sprints and Stacks
 

Último

Babel Compiler - Transforming JavaScript for All Browsers.pptx
Babel Compiler - Transforming JavaScript for All Browsers.pptxBabel Compiler - Transforming JavaScript for All Browsers.pptx
Babel Compiler - Transforming JavaScript for All Browsers.pptxYounusS2
 
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyesHow to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyesThousandEyes
 
OpenShift Commons Paris - Choose Your Own Observability Adventure
OpenShift Commons Paris - Choose Your Own Observability AdventureOpenShift Commons Paris - Choose Your Own Observability Adventure
OpenShift Commons Paris - Choose Your Own Observability AdventureEric D. Schabell
 
Digital magic. A small project for controlling smart light bulbs.
Digital magic. A small project for controlling smart light bulbs.Digital magic. A small project for controlling smart light bulbs.
Digital magic. A small project for controlling smart light bulbs.francesco barbera
 
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPA
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPAAnypoint Code Builder , Google Pub sub connector and MuleSoft RPA
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPAshyamraj55
 
AI Fame Rush Review – Virtual Influencer Creation In Just Minutes
AI Fame Rush Review – Virtual Influencer Creation In Just MinutesAI Fame Rush Review – Virtual Influencer Creation In Just Minutes
AI Fame Rush Review – Virtual Influencer Creation In Just MinutesMd Hossain Ali
 
Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Adtran
 
Crea il tuo assistente AI con lo Stregatto (open source python framework)
Crea il tuo assistente AI con lo Stregatto (open source python framework)Crea il tuo assistente AI con lo Stregatto (open source python framework)
Crea il tuo assistente AI con lo Stregatto (open source python framework)Commit University
 
Cloud Revolution: Exploring the New Wave of Serverless Spatial Data
Cloud Revolution: Exploring the New Wave of Serverless Spatial DataCloud Revolution: Exploring the New Wave of Serverless Spatial Data
Cloud Revolution: Exploring the New Wave of Serverless Spatial DataSafe Software
 
Basic Building Blocks of Internet of Things.
Basic Building Blocks of Internet of Things.Basic Building Blocks of Internet of Things.
Basic Building Blocks of Internet of Things.YounusS2
 
Things you didn't know you can use in your Salesforce
Things you didn't know you can use in your SalesforceThings you didn't know you can use in your Salesforce
Things you didn't know you can use in your SalesforceMartin Humpolec
 
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...DianaGray10
 
Computer 10: Lesson 10 - Online Crimes and Hazards
Computer 10: Lesson 10 - Online Crimes and HazardsComputer 10: Lesson 10 - Online Crimes and Hazards
Computer 10: Lesson 10 - Online Crimes and HazardsSeth Reyes
 
Videogame localization & technology_ how to enhance the power of translation.pdf
Videogame localization & technology_ how to enhance the power of translation.pdfVideogame localization & technology_ how to enhance the power of translation.pdf
Videogame localization & technology_ how to enhance the power of translation.pdfinfogdgmi
 
Linked Data in Production: Moving Beyond Ontologies
Linked Data in Production: Moving Beyond OntologiesLinked Data in Production: Moving Beyond Ontologies
Linked Data in Production: Moving Beyond OntologiesDavid Newbury
 
Nanopower In Semiconductor Industry.pdf
Nanopower  In Semiconductor Industry.pdfNanopower  In Semiconductor Industry.pdf
Nanopower In Semiconductor Industry.pdfPedro Manuel
 
COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online CollaborationCOMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online Collaborationbruanjhuli
 
Machine Learning Model Validation (Aijun Zhang 2024).pdf
Machine Learning Model Validation (Aijun Zhang 2024).pdfMachine Learning Model Validation (Aijun Zhang 2024).pdf
Machine Learning Model Validation (Aijun Zhang 2024).pdfAijun Zhang
 
GenAI and AI GCC State of AI_Object Automation Inc
GenAI and AI GCC State of AI_Object Automation IncGenAI and AI GCC State of AI_Object Automation Inc
GenAI and AI GCC State of AI_Object Automation IncObject Automation
 
IESVE Software for Florida Code Compliance Using ASHRAE 90.1-2019
IESVE Software for Florida Code Compliance Using ASHRAE 90.1-2019IESVE Software for Florida Code Compliance Using ASHRAE 90.1-2019
IESVE Software for Florida Code Compliance Using ASHRAE 90.1-2019IES VE
 

Último (20)

Babel Compiler - Transforming JavaScript for All Browsers.pptx
Babel Compiler - Transforming JavaScript for All Browsers.pptxBabel Compiler - Transforming JavaScript for All Browsers.pptx
Babel Compiler - Transforming JavaScript for All Browsers.pptx
 
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyesHow to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
 
OpenShift Commons Paris - Choose Your Own Observability Adventure
OpenShift Commons Paris - Choose Your Own Observability AdventureOpenShift Commons Paris - Choose Your Own Observability Adventure
OpenShift Commons Paris - Choose Your Own Observability Adventure
 
Digital magic. A small project for controlling smart light bulbs.
Digital magic. A small project for controlling smart light bulbs.Digital magic. A small project for controlling smart light bulbs.
Digital magic. A small project for controlling smart light bulbs.
 
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPA
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPAAnypoint Code Builder , Google Pub sub connector and MuleSoft RPA
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPA
 
AI Fame Rush Review – Virtual Influencer Creation In Just Minutes
AI Fame Rush Review – Virtual Influencer Creation In Just MinutesAI Fame Rush Review – Virtual Influencer Creation In Just Minutes
AI Fame Rush Review – Virtual Influencer Creation In Just Minutes
 
Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™
 
Crea il tuo assistente AI con lo Stregatto (open source python framework)
Crea il tuo assistente AI con lo Stregatto (open source python framework)Crea il tuo assistente AI con lo Stregatto (open source python framework)
Crea il tuo assistente AI con lo Stregatto (open source python framework)
 
Cloud Revolution: Exploring the New Wave of Serverless Spatial Data
Cloud Revolution: Exploring the New Wave of Serverless Spatial DataCloud Revolution: Exploring the New Wave of Serverless Spatial Data
Cloud Revolution: Exploring the New Wave of Serverless Spatial Data
 
Basic Building Blocks of Internet of Things.
Basic Building Blocks of Internet of Things.Basic Building Blocks of Internet of Things.
Basic Building Blocks of Internet of Things.
 
Things you didn't know you can use in your Salesforce
Things you didn't know you can use in your SalesforceThings you didn't know you can use in your Salesforce
Things you didn't know you can use in your Salesforce
 
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
 
Computer 10: Lesson 10 - Online Crimes and Hazards
Computer 10: Lesson 10 - Online Crimes and HazardsComputer 10: Lesson 10 - Online Crimes and Hazards
Computer 10: Lesson 10 - Online Crimes and Hazards
 
Videogame localization & technology_ how to enhance the power of translation.pdf
Videogame localization & technology_ how to enhance the power of translation.pdfVideogame localization & technology_ how to enhance the power of translation.pdf
Videogame localization & technology_ how to enhance the power of translation.pdf
 
Linked Data in Production: Moving Beyond Ontologies
Linked Data in Production: Moving Beyond OntologiesLinked Data in Production: Moving Beyond Ontologies
Linked Data in Production: Moving Beyond Ontologies
 
Nanopower In Semiconductor Industry.pdf
Nanopower  In Semiconductor Industry.pdfNanopower  In Semiconductor Industry.pdf
Nanopower In Semiconductor Industry.pdf
 
COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online CollaborationCOMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
 
Machine Learning Model Validation (Aijun Zhang 2024).pdf
Machine Learning Model Validation (Aijun Zhang 2024).pdfMachine Learning Model Validation (Aijun Zhang 2024).pdf
Machine Learning Model Validation (Aijun Zhang 2024).pdf
 
GenAI and AI GCC State of AI_Object Automation Inc
GenAI and AI GCC State of AI_Object Automation IncGenAI and AI GCC State of AI_Object Automation Inc
GenAI and AI GCC State of AI_Object Automation Inc
 
IESVE Software for Florida Code Compliance Using ASHRAE 90.1-2019
IESVE Software for Florida Code Compliance Using ASHRAE 90.1-2019IESVE Software for Florida Code Compliance Using ASHRAE 90.1-2019
IESVE Software for Florida Code Compliance Using ASHRAE 90.1-2019
 

OpenStack documentation & translation management 2012_summit

  • 1. The OpenStack Summit San Diago 2012 OpenStack Documentation and Translation Management Ying Chun Guo (Daisy) Anne Gentle OpenStack Doc Team OpenStack Doc Team guoyingc@cn.ibm.com anne@openstack.org © 2009 IBM Corporation
  • 2. Agenda Status of OpenStack Document Translation Management & Process Samples of Translation Process Plans for next steps Questions with Answers www.openstack.org 2
  • 3. Agenda Status of OpenStack Document Translation Management & Process Samples of Translation Process Plans for next steps Questions with Answers www.openstack.org 3
  • 4. 文档页面 Web Page for Documentation http://docs.openstack.org www.openstack.org
  • 5. Challenges of Community Document Large amount of code Grow quickly Change frequently Loose coupling Manage document as code ! www.openstack.org 5
  • 6. Document Process: Design Blueprints and discussion at Design Summit Blueprints Current blueprints found at https://blueprints.launchpad.net/openstack-manuals www.openstack.org 6
  • 7. Document Process : Development Github repositories store admin guides and API guides Unit tests with Jenkins Patch review with Gerrit www.openstack.org 7
  • 8. Document Process : Bug tracking Manage bugs through Lanuchpad Bug logging Bug triaging Bug assigning www.openstack.org 8
  • 9. Document Process : Publishing Automatically publish with Jenkins www.openstack.org 9
  • 10. Doc Team Composition All OpenStack community members One percenters = OpenStack-doc-core Badge Wearers AT&T IBM Nebula Nicira Nimbis Services Nuage Rackspace RedHat www.openstack.org 10
  • 11. Statics 20+ Compute Extensions documented at api.openstack.org 66% Site visitors stay instead of leaving 100 Doc patches and reviews a month 726 Configuration options : 467 for nova.conf, 259 for swift conf files 10,000 Unique visitors a week at docs.openstack.org www.openstack.org 11
  • 12. Agenda Status of OpenStack Document Translation Management & Process Samples of Translation Process Plans for next steps Questions with Answers www.openstack.org 12
  • 13. Challenges of Document Translation Large amount of code Grow quickly Change frequently Loose coupling Manage document translation as code string translation! www.openstack.org 13
  • 14. Translation Process : Slicing Slice DocBook into string segment with a Python script, and generate a PO template ./tools/generatepot openstack-compute-admin www.openstack.org 14
  • 15. Translation Process : Translating Manage translation by Transifex Translation project & resources Translation memory Glossary www.openstack.org 15
  • 16. Translation Process : Merging Merge the translated string into Docbook with a python script. ./tools/generatedocbook -l zh_CN -b openstack-compute-admin www.openstack.org 16
  • 17. Translation Process : Uploading & Downloading Upload the translation resources and download the translated results by commands of Transifex Client. tx set --auto-local -r openstack-manuals-i18n.openstack-api- programming 'doc/src/docbkx/openstack-api- programming/locale/<lang>.po' --source-lang en --source-file doc/src/docbkx/openstack-api-programming/locale/openstack-api- programming.pot –execute tx pull -f -l zh_CN -r openstack-manuals-i18n.api-quick-start tx push -s -r openstack-manuals-i18n.api-quick-start www.openstack.org 17
  • 18. Translation Process : Change Management Synchronize the local translation resources with the resources in the Transifex server by Transifex Client commands. Command “tx push” will automatically check the differences and merge the local copy and remote copy. New strings will be added. Modified strings will be considered new ones and added as well. Strings which do not exist in the new source file (including ones which have been modified) will be removed from the database. The removed translations are kept in the Translation Memory of your project. ./tools/generatedocbook -l zh_CN -b openstack-manuals-i18n.api-quick- start tx push -s -r openstack-manuals-i18n.api-quick-start tx pull -r openstack-manuals-i18n.api-quick-start www.openstack.org 18
  • 19. Statics 5 languages translation started Chinese – 11%, Spanish – 5%, Czech – 3%, Korean, French 15+ translators contributed. Chinese translations “OpenStack API Quick Start” 100% finished “Network Administration Guide” 59% finished “OpenStack Install and Deploy Manual” 44% finished www.openstack.org 19
  • 20. Agenda Status of OpenStack Document Translation Management & Process Samples of Translation Process Plans for next steps Questions with Answers www.openstack.org 20
  • 21. Sample : Chinese Document Generation Step 1: Check out the sources from Git repository git clone https://github.com/daisy-ycguo/openstack-manuals-i18n.git Step 2: Check out the latest translation from Transifex tx pull -f -l zh_CN -r openstack-manuals-i18n.api-quick-start www.openstack.org 21
  • 22. Sample : Chinese Document Generation Step 3: Merge the translation segments back to DocBook ./tools/generatedocbook -l zh_CN -b api-quick-start Step 4: Generate PDF and HTML document mvn generate-sources www.openstack.org
  • 23. Agenda Status of OpenStack Document Translation Management & Process Samples of Translation Process Plans for next steps Questions with Answers www.openstack.org 23
  • 24. Plans for next steps Integrate the process into Continuous Integration system. Slicing & uploading Downloading Merging & publishing to website automatically Updating Resolve the issue: lack of translation context after slicing into statements. Using a website to show the up-to-date translated documents, to facilitate the translators to check their translation results at any time. Any kinds of contributions to translation process is warmly welcomed ! www.openstack.org
  • 25. Agenda Status of OpenStack Document Translation Management & Process Samples of Translation Process Plans for next steps Questions with Answers www.openstack.org 25
  • 26. How can I get on the openstack-core-docs team? Do lots of reviews at http://review.openstack.org for the openstack- manuals project. Triage bugs and log doc bugs at http://bugs.launchpad.net/openstack-manuals. We’ll discuss on the openstack-docs-core mailing list and then invite you. www.openstack.org 26
  • 27. How should I find doc work that needs to be done on a particular project? Refer to http://bugs.launchpad.net/openstack-manuals and look for Wishlist for tasks, or any doc bug can be picked up as a work item. We also track few blueprints which may need someone to work on, though doc bugs are probably the best first place to look www.openstack.org 27
  • 28. Who should do reviews of my document changes? Anne Gentle, the doc coordinator, or anyone on the openstack-doc- core team can help you identify reviewers, or you can also check the doc bug and ask the reporter to review the changes by adding their name to the reviewers list. www.openstack.org 28
  • 29. How to contribute the translations ? If you want to contribute the translations, you need to register an account at Transifex, and then go to openstack-manuals translation page. After that, select the languages you prefer, all of the language resources will be listed. Then select the resources you want to work on and click it. Click “Translate Now” in the pop-up dialog. www.openstack.org 29
  • 30. How to get the latest translation documents ? Check out the latest resources from Git repository at first, and then check out the latest translation from Transifex. After that, merge the translation segment back to DocBook by running the Python script and generate PDF and HTML document by running Maven build. Refer to “Sample: Chinese Document Generation” www.openstack.org 30
  • 31. Conclusion Managing document as code is key feature of OpenStack documentation. The translation is just started. I will need the support and participation from all of you. Your participation is warmly welcomed. For any problems about documentation, please contact with Anne Gentle. For any problems about translation, please contact with Ying Chun Guo. www.openstack.org 31
  • 32. Reference Documentation page http://docs.openstack.org Blueprints of documents https://blueprints.launchpad.net/ openstack-manuals Bugs of documents http://bugs.launchpad.net/openstack-manuals Main page for openstack-manuals translation in Transifex https://www.transifex.net/projects/p/openstack-manuals-i18n/ OpenStack Document Translation Guide https://gist.github.com/3037139 Address of Chinese Openstack manuals (as temporary) http://1.openstackcn.sinaapp.com/?page_id=8 www.openstack.org