Jump to: navigation, search

Difference between revisions of "I18nTeam/docs-translation"

(Alternative suggestion of categorization)
m
 
(25 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
[[Category:I18n]]
 +
 +
This page is not maintained now (Aug 2017).
 +
The documentation structure is being restructured drastically.
 +
 
=== Document categorize ===
 
=== Document categorize ===
 
Translation team use this page to track the status of documents and decide the priorities of translation.
 
Translation team use this page to track the status of documents and decide the priorities of translation.
  
{| class="wikitable"
+
{| class="wikitable sortable centre" style="text-align: center;"
 +
|-
 +
! scope="col" | Resources
 +
! scope="col" | Target
 +
! scope="col" | Update Frequency
 +
! scope="col" | Priority
 +
! scope="col" | Comments
 
|-
 
|-
! Changes !! End users !! Admins !! Developers
+
| admin-guide-cloud || Admin || Content stable || 2 - Medium || Under reorganization for Mitaka, from role-based to task-based
 
|-
 
|-
| Frequently changed || || ||
+
| api-guide || Developers || Stable || 1 - High ||  
 
|-
 
|-
| Changed a few || || ||
+
| api-ref-guides || Developers || Stable || 3 - Low || Contains WADLS we can't translate at the moment
 
|-
 
|-
| Stable || || || API Quick Start (1,077words)
+
| arch-design || Admin || Content stable || 3 - Low || Under reorganization for Mitaka
|}
 
 
 
=== Alternative suggestion of categorization ===
 
 
 
Here is a small example :
 
 
 
{| class="wikitable sortable centre"
 
 
|-
 
|-
! scope="col" | Projects
+
| api-ref || Developers || Unstable || 3 - Low || API is going to be changed. So this doc will be changed in the future.
! scope="col" | Ressources
 
! scope="col" | Type
 
! scope="col" | Target
 
! scope="col" | Frequently changed
 
! scope="col" | Size
 
! scope="col" | Priority
 
! scope="col" | Comments
 
 
|-
 
|-
| Horizon || Juno - Horizon Translations || UI || End users || ||  || 1 - High ||  
+
| user-guide || End users || Content stable || 1 - High ||  
 
|-
 
|-
| OpenStack Manuals ||  api-quick-start || Documentation || Developers || Stable || 1 077 || 1 - High ||
+
| user-guide-admin || Admin || Content stable || 3 - Low || Under reorganization for Mitaka, will be merged into admin-guide-cloud and removed
 
|-
 
|-
| OpenStack Manuals || z-old-basic-install  || Documentation || n/a || Archived || 1 264 || 4 - To be deleted ||  
+
| common || Common || Stable || 2 - Medium || Glossary (RST) and contents are used by other books
 
|-
 
|-
| OpenStack Manuals || api-guide || Documentation || Developers || Stable || 103 || 1 - High || Contains WADLS we can't translate at the moment
+
| glossary || Common || Stable || 3 - Low || For DocBook, glossary for RST is inside common
 
|-
 
|-
| OpenStack Manuals ||  api-ref-guides || Documentation || Developers || Stable || 211 || 1 - High || Contains WADLS we can't translate at the moment
+
| install-guide || Admin || Stable || 1 - High || Work In Progress
 
|-
 
|-
| OpenStack Manuals || api-ref || Documentation || Developers || Stable || 4 151  || 1 - High ||  
+
| ha-guide || Admin || Unstable || 3 - Low ||
 
|-
 
|-
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||  
+
| openstack-ops || End users || Content stable || 2 - Medium || Plan to be reorganized for Newton
 
|-
 
|-
| OpenStack Manuals || z-old-openstack-install  || Documentation || Admin || Archived || 17 101 || 4 - To be deleted ||  
+
| config-reference || Admin || Unstable || 3 - Low ||
 
|-
 
|-
| OpenStack Manuals || z-old-openstack-compute-admin || Documentation || Admin || Archived || 38 990 || 4 - To be deleted ||  
+
| image-guide || End users || Unstable || 2 - Medium ||
 
|-
 
|-
| OpenStack Manuals || user-guide-admin || Documentation || Admin || Unstable || 7 480 || 3 - Low ||  
+
| security-guide || Admin || Stable || 2 - Medium ||
 
|-
 
|-
| OpenStack Manuals || Common || Documentation || Common || Unstable || 73 557 || 2 - Medium || Config tables will be moved out of common into config-reference
+
| upgrade-guide || Admin || ??? || ??? || Under discussion (at now, inside OpsGuide)
 
|-
 
|-
| OpenStack Manuals || install-guide || Documentation || Admin || Stablises ~1 week after release || 20 190 || 2 - Medium || Stablises ~1 week after release, then about 1 month after that becomes unstable again
+
| networking-guide || Admin || Stable || 2 - Medium ||
 
|-
 
|-
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||
 
|-
 
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||
 
|-
 
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||
 
 
|}
 
|}
 
===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