{"thread":{"id":"8603","subject":"Re: [RFD] Documentation/HOWTO translated into Japanese","startedAt":"2007-06-15T00:29:09Z","lastAt":"2007-06-15T00:29:09Z","messageCount":1,"participants":["Kyle Moffett"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"45099","messageId":"29741172-099F-499B-8A73-A85C6360129D@mac.com","threadId":"8603","inReplyTo":"12c511ca0706111038j37e188b6n2677b1789d14de23@mail.gmail.com","subject":"Re: [RFD] Documentation/HOWTO translated into Japanese","fromName":"Kyle Moffett","fromEmail":"mrmacman_g4@mac.com","sentAt":"2007-06-15T00:29:09Z","receivedAt":"2007-06-15T00:29:09Z","isPatch":false,"sender":{"key":"mrmacman_g4@mac.com","avatar":null},"body":"On Jun 11, 2007, at 13:38:10, Tony Luck wrote:\n>> I'd rather have a single file, marked \"Japanese\" (in Japanese),  \n>> that had pointers to current translations. These will always be at  \n>> least as current as whatever we have in the tree, if not more so.  \n>> Especially when someone is trying to figure out how to work based  \n>> on the year-old kernel their embedded vendor gave them.\n>\n> Knowing whether a translation is current or not would be useful ...  \n> perhaps the translated files could include the GIT blob SHA1 of the  \n> version they were translated from (and some human readable version  \n> string too :-) This would allow someone reading the documentation  \n> to know whether is really was current.  If it isn't, it provides an  \n> easy path to see what changed in the source document since the  \n> translation was made. This same diff should lighten the load for  \n> people maintaining the translation.\n\nWell, actually, if you're going that route then extend GIT to have  \nsupport for \"related\" files.  Essentially you should be able to add  \nmetadata to a git tree which says: \"files $SHA1-$PATH1, $SHA2-$PATH2,  \n[...], are related\".  Then there would be a \"git list-related\"  \ncommand with a \"--mismatch\" option which would list paths for which  \n$SHA1 doesn't correspond to $PATH1 or $SHA2 doesn't correspond to  \n$PATH2, etc.  Some clever updating of related-status during commit/ \nclone/pull/etc could store information in the index about whether or  \nnot any given file is up-to-date with respect to its co-related files.\n\nFor translations, when the English version of a document is updated  \nit will automatically result in a \"mismatch\", allowing translators to  \ndo a simple git-diff and see what happened.  Likewise, if the  \nJapanese document is updated without changing the relationship then  \nit might mean that somebody should see what changed and update the  \nEnglish version as well.  If you determine that the change was  \nirrelevant for the other language (spelling/grammar fixes, etc), then  \nyou just update the relationship and commit that change.\n\nIt would probably be pretty trivial to implement a prototype using a  \n'.gitrelated' file in the root of the git tree, although better  \nintegration with the index would really speed handling with lots of  \nrelated files; instead of linear searching just iterate over the  \nprepared-during-checkout \"out-of-date\" list.\n\nCheers,\nKyle Moffett\n"}]}