Difference between revisions of "Babel / Development Status Meetings / 2009-09-28"

From Eclipsepedia

Jump to: navigation, search
m (Topics)
(Attendees)
 
(3 intermediate revisions by one user not shown)
Line 4: Line 4:
 
|-
 
|-
 
| Kit  
 
| Kit  
|  
+
| Y
 
|-
 
|-
 
| Denis  
 
| Denis  
|  
+
| Y
 
|-
 
|-
 
| Gabe  
 
| Gabe  
|  
+
| Y
 
|-
 
|-
 
| Antoine  
 
| Antoine  
Line 19: Line 19:
 
|-
 
|-
 
| Jeff  
 
| Jeff  
|  
+
| Y
 
|-
 
|-
 
| Margaret  
 
| Margaret  
Line 29: Line 29:
 
*{{bug|283734}} Documentation Best Practices
 
*{{bug|283734}} Documentation Best Practices
 
**I'm starting to look in more details on how to build translated doc files.
 
**I'm starting to look in more details on how to build translated doc files.
**Looks like the idea gears more towards developers / doc writers, recommending to signle source the doc files at a wiki.
+
**Looks like the idea gears more towards developers / doc writers, recommending to signle source the doc files on a wiki.
 
**There are tools to help convert HTML doc files to wiki format. However, as with any conversion process, some minor manual clean up are needed after the conversion.
 
**There are tools to help convert HTML doc files to wiki format. However, as with any conversion process, some minor manual clean up are needed after the conversion.
 
**Our current thought of extracting the HTML doc files from repositories, translate, convert to wiki format and publish may not work very well.
 
**Our current thought of extracting the HTML doc files from repositories, translate, convert to wiki format and publish may not work very well.
 
**Wiki conversion tools are not perfect yet. The minor manual clean up may be a problem.
 
**Wiki conversion tools are not perfect yet. The minor manual clean up may be a problem.
**If a HTML doc file is translated into 34 languages, each translate has to decide on how the author wants the contents to be layout and displayed if the tag is not automatically converted.
+
**If a HTML doc file is translated into 34 languages, each translator has to decide on how the author wants the contents to be layout and displayed if the tag is not automatically converted.
 
**HTML doc files also reference image files in the doc plugin.
 
**HTML doc files also reference image files in the doc plugin.
**We have to have the English HTML doc files and image files in place at the wiki first. Otherwise, the translated doc files cannot reference the image files.
+
**We have to have the English HTML doc files and image files in place on the wiki first. Otherwise, the translated doc files cannot reference the image files.
 
**To sum up, we probably have to wait till some projects are following these Best Practices and hosting their doc files at the wiki first. Then we will work on the translation process of the wiki doc files.
 
**To sum up, we probably have to wait till some projects are following these Best Practices and hosting their doc files at the wiki first. Then we will work on the translation process of the wiki doc files.
 +
**Denis or Gabe, do you know how we host the doc files at: http://help.eclipse.org/galileo/index.jsp ?
 
[[Category:Babel]]
 
[[Category:Babel]]

Latest revision as of 11:55, 5 October 2009

[edit] Attendees

Kit Y
Denis Y
Gabe Y
Antoine  
Nigel  
Jeff Y
Margaret  

[edit] Topics

  • bug 283734 Documentation Best Practices
    • I'm starting to look in more details on how to build translated doc files.
    • Looks like the idea gears more towards developers / doc writers, recommending to signle source the doc files on a wiki.
    • There are tools to help convert HTML doc files to wiki format. However, as with any conversion process, some minor manual clean up are needed after the conversion.
    • Our current thought of extracting the HTML doc files from repositories, translate, convert to wiki format and publish may not work very well.
    • Wiki conversion tools are not perfect yet. The minor manual clean up may be a problem.
    • If a HTML doc file is translated into 34 languages, each translator has to decide on how the author wants the contents to be layout and displayed if the tag is not automatically converted.
    • HTML doc files also reference image files in the doc plugin.
    • We have to have the English HTML doc files and image files in place on the wiki first. Otherwise, the translated doc files cannot reference the image files.
    • To sum up, we probably have to wait till some projects are following these Best Practices and hosting their doc files at the wiki first. Then we will work on the translation process of the wiki doc files.
    • Denis or Gabe, do you know how we host the doc files at: http://help.eclipse.org/galileo/index.jsp ?