Clover wrote:
Question: do DevMO/l10n have to be exact translations (e.g. can l10n pages have different index pages, like on MS site)?
I'm not sure what's best. Can you say more about why the MSDN localizations have different index pages and possibly other structure?
If you go to microsoft site or MSDN, and then to the Taiwan version, you won't find any file-to-file relationship. The Taiwan pages have very different layout. The English version and Taiwan version have similar file structure, but they have diffierent articles. For example, on MSDN Taiwan you can see articles written by Taiwanese (which aren't translated to English).
I would suggest the following editing rules:
- Every article must be reviewed for grammar, spelling, readability etc. - All articles have to be complete - Every article must have a publish date - Every article should indicate what version of software it is applicabel to - We accept non-trivial content updates - updated page must have a Update Date - details need to be reviewed for version applicability - Links can be added, removed, updated without changing the document date. - We will NOT accept grammar and spelling changes
In general, we would ensure that all docs have print, professional quality. This would have the following advantage:
- Translators can translate a page and be done with it. S/he doesn't have to watch the doc
- We don't have to review and update every page whenever we roll out a new software version. The Date and Version fields would imply if a doc is still relevant.
- We encourage people to write more
- We stop wasting time on old docs. If they are obsolete, and updating the doc takes no trivial effort, we can just give up on the doc.
- People sometimes file bug reports that a doc refers to a software that has a new version and the version/link needs to be updated. This is silly; we shouldn't try make sure everything is up-to-date to minute details.
- Most doc writers don't have time to maintain their own docs. This relieve them from such obligation
- All doc writers can go on a summar vacation and the site will still run smoothly.
_______________________________________________
mozilla-documentation mailing list
[EMAIL PROTECTED]
http://mail.mozilla.org/listinfo/mozilla-documentation
