Difference between revisions of "Talk:Documentation Improvement"
From GnuCash
(→Page doesn' mention the translation process: fixed typo & added to discussion) |
(→Page doesn't mention the translation process: updated my comment) |
||
| Line 14: | Line 14: | ||
:::Thank you VERY much for the link! I believe that link is a very helpful cue. | :::Thank you VERY much for the link! I believe that link is a very helpful cue. | ||
| − | :::The email above suggested adding comments (for translators to see) embedded in the DocBook source to point to major rearrangements or added sections. I haven't yet looked through the existing source for such comments, but my thought was if they are helpful this page could suggest where and how to add them, following whatever convention has already been established. | + | :::The email above suggested adding comments (for translators to see) embedded in the DocBook source to point to major rearrangements or added sections. I haven't yet looked through the existing source for such comments, but my thought was if they are helpful this page could suggest where and how to add them, following whatever convention has already been established. [UPDATE: A quick glance through a few chapters shows this particular suggestion really applies ONLY to the Book file, and not to any of the chapters, at least not as they are written now.] |
:::The page collects a few similar "conventions" at the end (including one begging for more). The documentation trade calls those notes a "style guide." [[User:Twt|Twt]] ([[User talk:Twt|talk]]) 07:41, 18 February 2015 (UTC) | :::The page collects a few similar "conventions" at the end (including one begging for more). The documentation trade calls those notes a "style guide." [[User:Twt|Twt]] ([[User talk:Twt|talk]]) 07:41, 18 February 2015 (UTC) | ||
Revision as of 07:52, 18 February 2015
Page doesn't mention the translation process
I just noticed the following message on gnucash-devel:
http://lists.gnucash.org/pipermail/gnucash-devel/2015-February/038536.html
mentioning an implication of documentation updates to translations. Currently (16 February 2015) the documentation updates procedure doesn't even mention the translation process.
Twt (talk) 23:49, 16 February 2015 (UTC)
- So? The wiki can't document everything, especially when it comes to craft knowledge.
- Thank you VERY much for the link! I believe that link is a very helpful cue.
- The email above suggested adding comments (for translators to see) embedded in the DocBook source to point to major rearrangements or added sections. I haven't yet looked through the existing source for such comments, but my thought was if they are helpful this page could suggest where and how to add them, following whatever convention has already been established. [UPDATE: A quick glance through a few chapters shows this particular suggestion really applies ONLY to the Book file, and not to any of the chapters, at least not as they are written now.]
