Return-Path: X-Original-To: apmail-incubator-flex-dev-archive@minotaur.apache.org Delivered-To: apmail-incubator-flex-dev-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 9BAFE9E74 for ; Fri, 10 Feb 2012 18:58:51 +0000 (UTC) Received: (qmail 54719 invoked by uid 500); 10 Feb 2012 18:58:51 -0000 Delivered-To: apmail-incubator-flex-dev-archive@incubator.apache.org Received: (qmail 54634 invoked by uid 500); 10 Feb 2012 18:58:50 -0000 Mailing-List: contact flex-dev-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: flex-dev@incubator.apache.org Delivered-To: mailing list flex-dev@incubator.apache.org Received: (qmail 54626 invoked by uid 99); 10 Feb 2012 18:58:50 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 10 Feb 2012 18:58:50 +0000 X-ASF-Spam-Status: No, hits=-0.7 required=5.0 tests=RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: local policy) Received: from [80.237.132.80] (HELO wp073.webpack.hosteurope.de) (80.237.132.80) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 10 Feb 2012 18:58:41 +0000 Received: from p4aa831.osaknt01.ap.so-net.ne.jp ([120.74.168.49] helo=[192.168.1.21]); authenticated by wp073.webpack.hosteurope.de running ExIM with esmtpsa (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) id 1Rvvfo-0002PL-RM; Fri, 10 Feb 2012 19:58:21 +0100 Message-ID: <4F3568C1.6080704@leichtgewicht.at> Date: Sat, 11 Feb 2012 03:58:09 +0900 From: Martin Heidegger User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:10.0) Gecko/20120129 Thunderbird/10.0 MIME-Version: 1.0 To: flex-dev@incubator.apache.org Subject: Re: [RT] Documentation (split from: Awesome User Experience) References: <4F353F10.6090700@leichtgewicht.at> <4F354928.7000807@leichtgewicht.at> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-bounce-key: webpack.hosteurope.de;mh@leichtgewicht.at;1328900321;15c0c6e5; X-Virus-Checked: Checked by ClamAV on apache.org On 11/02/2012 02:56, David Francis Buhler wrote: > I'm curious how Open-Source projects handle the localization of documentation. - Every system does it differently, this can be handled in a lot of ways. I structure it for me like that: - If documentation is deployed with the release of a project then every "localization team" has time to the release to add documentation and either they deploy with untranslated parts or deploy the translated parts once each translation is done. - If the documentation is on a global service (homepage) then usually the english page is first there and the translators translate as they pass by. (See php documentation). - Projects that do not change over a long time due to their simplicity (small JavaScript projects) usually can have one documentation and the documentation gets a version related to but not similar to the project. API-doc translation is something that is missing in the FLEX SDK for years now - I had particular difficult discussions about that in the Java Community. I have two concepts for that lying around somewhere. If we have wiki it would work like: > ...ng Tour de Flex, I'm not sure how effective it is. I am not saying that we should continue it, I have certainly not used it ... > If people have found the application to be helpful, I'd be interested in hearing more. Me too. yours Martin.