Jump to: navigation, search

Difference between revisions of "I18nTeam/docs-translation"

m (Document categorize)
m
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Category:I18n]]
 
[[Category:I18n]]
 +
 +
This page is not maintained now (Aug 2017).
 +
The documentation structure is being restructured drastically.
  
 
=== Document categorize ===
 
=== Document categorize ===
Line 7: Line 10:
 
|-  
 
|-  
 
! scope="col" | Resources
 
! scope="col" | Resources
! scope="col" | Type
 
 
! scope="col" | Target  
 
! scope="col" | Target  
 
! scope="col" | Update Frequency
 
! scope="col" | Update Frequency
Line 13: Line 15:
 
! scope="col" | Comments
 
! scope="col" | Comments
 
|-
 
|-
| admin-guide-cloud || Documentation || Admin || Content stable || 3 - Low || Will be converted to RST, without content changed, then rearranged to Liberty
+
| admin-guide-cloud || Admin || Content stable || 2 - Medium || Under reorganization for Mitaka, from role-based to task-based
|-
 
| api-quick-start || Documentation || Developers || Stable || 1 - High ||
 
|-
 
| api-guide || Documentation || Developers || Stable || 3 - Low || Contains WADLS we can't translate at the moment
 
 
|-
 
|-
| api-ref-guides || Documentation || Developers || Stable || 3 - Low || Contains WADLS we can't translate at the moment
+
| api-guide || Developers || Stable || 1 - High ||  
 
|-
 
|-
| arch-design || Documentation || Admin || Unstable || 3 - Low || printed book, needs to be rewritten.
+
| api-ref-guides || Developers || Stable || 3 - Low || Contains WADLS we can't translate at the moment
 
|-
 
|-
| api-ref || Documentation || Developers || Stable || 1 - High || API is going to be changed. So this doc will be changed in the future.
+
| arch-design || Admin || Content stable || 3 - Low || Under reorganization for Mitaka
 
|-
 
|-
| user-guide || Documentation || End users || Unstable || 1 - High || Will be rearranged to Liberty
+
| api-ref || Developers || Unstable || 3 - Low || API is going to be changed. So this doc will be changed in the future.
 
|-
 
|-
| user-guide-admin || Documentation || Admin || Unstable || 3 - Low || Will be rearranged to Liberty
+
| user-guide || End users || Content stable || 1 - High ||  
 
|-
 
|-
| common || Documentation || Common || Unstable || 2 - Medium || Config tables will be moved out of common into config-reference. Content is used by other books, especially translate preface and support appendix (ch_preface.xml and app_support.xml)!
+
| user-guide-admin || Admin || Content stable || 3 - Low || Under reorganization for Mitaka, will be merged into admin-guide-cloud and removed
 
|-
 
|-
| common-rst || Documentation || Common || Unstable || 2 - Medium || Glossary (RST) and contents are used by other books
+
| common || Common || Stable || 2 - Medium || Glossary (RST) and contents are used by other books
 
|-
 
|-
| install-guide || Documentation || Admin || Unstable || 2 - Medium || Will be converted to RST, content rearranged, RefCore will be included, for Kilo release
+
| glossary || Common || Stable || 3 - Low || For DocBook, glossary for RST is inside common
 
|-
 
|-
| training-guides || Documentation || End users || Do not translate || 4 - To be rewrite || Needs a complete rewrite in the future
+
| install-guide || Admin || Stable || 1 - High || Work In Progress
 
|-
 
|-
| cli-reference || Documentation || End users || Unstable || 2 - Medium || Auto generated, will evaluate how to generate
+
| ha-guide || Admin || Unstable || 3 - Low ||
 
|-
 
|-
| high-availability-guide || Documentation || Admin || Do not translate || 4 - To be rewrite || Will change to RST, might be the first one in Liberty to be ready for translation
+
| openstack-ops || End users || Content stable || 2 - Medium || Plan to be reorganized for Newton
 
|-
 
|-
| hot-reference || Documentation || End users || Do not translate || 1 - High || Will change to RST
+
| config-reference || Admin || Unstable || 3 - Low ||
 
|-
 
|-
| glossary || Documentation || Common || Stable || 1 - High || 08/21/2014 - Waiting for a feedback from the doc team about the content of the Glossary
+
| image-guide || End users || Unstable || 2 - Medium ||
 
|-
 
|-
| openstack-ops || Documentation || End users || Stable || 2 - Medium || Won't be converted for RST for a long time
+
| security-guide || Admin || Stable || 2 - Medium ||
 
|-
 
|-
| config-reference || Documentation || Admin || Unstable || 3 - Low || Config tables will be moved out of common into config-reference, auto generated
+
| upgrade-guide || Admin || ??? || ??? || Under discussion (at now, inside OpsGuide)
 
|-
 
|-
| image-guide || Documentation || End users || Stable || 2 - Medium ||  
+
| networking-guide || Admin || Stable || 2 - Medium ||
|-
 
| security-guide || Documentation || Admin || Becoming Stable || 3 - Low || Out of date, will be rearranged.
 
|-
 
| upgrade-guide || Documentation || Admin || ??? || ??? || Cannot find it (at now, inside OpsGuide)
 
|-
 
| networking-guide || Documentation || Admin || Unstable - draft || 4 - Do not translate yet || Will be finished for Liberty. Under drafting
 
 
|-
 
|-
 
|}
 
|}
 
===Discussion===
 
* Attempt at categorising documents: https://etherpad.openstack.org/p/i18n-manuals-classification
 

Latest revision as of 14:35, 4 August 2017


This page is not maintained now (Aug 2017).
The documentation structure is being restructured drastically.

Document categorize

Translation team use this page to track the status of documents and decide the priorities of translation.

Resources Target Update Frequency Priority Comments
admin-guide-cloud Admin Content stable 2 - Medium Under reorganization for Mitaka, from role-based to task-based
api-guide Developers Stable 1 - High
api-ref-guides Developers Stable 3 - Low Contains WADLS we can't translate at the moment
arch-design Admin Content stable 3 - Low Under reorganization for Mitaka
api-ref Developers Unstable 3 - Low API is going to be changed. So this doc will be changed in the future.
user-guide End users Content stable 1 - High
user-guide-admin Admin Content stable 3 - Low Under reorganization for Mitaka, will be merged into admin-guide-cloud and removed
common Common Stable 2 - Medium Glossary (RST) and contents are used by other books
glossary Common Stable 3 - Low For DocBook, glossary for RST is inside common
install-guide Admin Stable 1 - High Work In Progress
ha-guide Admin Unstable 3 - Low
openstack-ops End users Content stable 2 - Medium Plan to be reorganized for Newton
config-reference Admin Unstable 3 - Low
image-guide End users Unstable 2 - Medium
security-guide Admin Stable 2 - Medium
upgrade-guide Admin  ???  ??? Under discussion (at now, inside OpsGuide)
networking-guide Admin Stable 2 - Medium