Jump to: navigation, search

Difference between revisions of "I18nTeam/docs-translation"

m (Document categorize)
m
 
(7 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
 
 
|-
 
|-
| arch-design || Documentation || Admin || Unstable || 3 - Low || printed book, needs to be rewritten.
+
| api-guide || Developers || Stable || 1 - High ||  
 
|-
 
|-
| api-ref || Documentation || Developers || Stable || 1 - High || API is going to be changed. So this doc will be changed in the future.
+
| api-ref-guides || Developers || Stable || 3 - Low || Contains WADLS we can't translate at the moment
 
|-
 
|-
| user-guide || Documentation || End users || Unstable || 1 - High || Will be rearranged to Liberty
+
| arch-design || Admin || Content stable || 3 - Low || Under reorganization for Mitaka
 
|-
 
|-
| user-guide-admin || Documentation || Admin || Unstable || 3 - Low || 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.
 
|-
 
|-
| 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 || End users || Content stable || 1 - High ||  
 
|-
 
|-
| install-guide || Documentation || Admin || Unstable || 2 - Medium || Will be converted to RST, content rearranged, RefCore will be included, for Kilo release
+
| user-guide-admin || Admin || Content stable || 3 - Low || Under reorganization for Mitaka, will be merged into admin-guide-cloud and removed
 
|-
 
|-
| training-guides || Documentation || End users || Do not translate || 4 - To be rewrite || Needs a complete rewrite in the future
+
| common || Common || Stable || 2 - Medium || Glossary (RST) and contents are used by other books
 
|-
 
|-
| cli-reference || Documentation || End users || Unstable || 2 - Medium || Auto generated, will evaluate how to generate
+
| glossary || Common || Stable || 3 - Low || For DocBook, glossary for RST is inside common
 
|-
 
|-
| 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
+
| install-guide || Admin || Stable || 1 - High || Work In Progress
 
|-
 
|-
| hot-reference || Documentation || End users || ??? || 1 - High || Will change to RST
+
| ha-guide || 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
+
| openstack-ops || End users || Content stable || 2 - Medium || Plan to be reorganized for Newton
 
|-
 
|-
| openstack-ops || Documentation || End users || Quite Stable || 3 - Low || Won't be converted for RST for a long time
+
| config-reference || Admin || Unstable || 3 - Low ||
 
|-
 
|-
| config-reference || Documentation || Admin || Unstable || 3 - Low || Config tables will be moved out of common into config-reference, auto generated
+
| image-guide || End users || Unstable || 2 - Medium ||
 
|-
 
|-
| image-guide || Documentation || End users || Becoming Stable || 2 - Medium ||  
+
| security-guide || Admin || Stable || 2 - Medium ||
 
|-
 
|-
| security-guide || Documentation || Admin || Becoming Stable || 3 - Low || Out of date, will be rearranged.
+
| upgrade-guide || Admin || ??? || ??? || Under discussion (at now, inside OpsGuide)
 
|-
 
|-
| upgrade-guide || Documentation || Admin || ??? || 3 - Low || Cannot find it
+
| networking-guide || Admin || Stable || 2 - Medium ||
|-
 
| 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