Hi Gunnar, Appreciate you taking time to provide your details! I will do more research on them.
One question: Why add Chinese directory that corresponds with the English version rather than create a specific section/place? In the latter situation, Chinese (large number of users) could locate their desired information with fastest and fewest clicks, the user experience & user usability will be improved significantly, consequently it will contribute to the promotion of Apache Trafodion website as well. Thanks! Liu Yu -----Original Message----- From: Gunnar Tapper [mailto:[email protected]] Sent: Wednesday, July 13, 2016 11:26 AM To: [email protected] Cc: Dave Birdsall <[email protected]>; Jin, Jian (Seth) <[email protected]>; Yang, Yang (Felix) <[email protected]> Subject: Re: Chinese Contributor Access Hi, It's definitely a good idea to add a set of Chinese-language pages and user guides. Most of the documentation and web pages are located under the docs/ directory. I propose that we keep this simple: simply add a [document]_cn directory that corresponds with the English version. For example, docs/sql_reference and docs/sql_reference_cn. The documents are written in asciidoctor so I think we'll be OK there. The current PDF tool will not do good so we'll probably need to change to asciidoctor-fopub. See http://programfan.github.io/contents/2015/04/20/convert-chinese-asciidoc-to-pdf/ The website uses markdown. From what I can see, this should work. There's even a guide: http://markdown.tw/ Here, I propose that the differnet web pages are complimented with a _cn counterpart. See src/site/markdown/. We may have to do some css work, which I view as a good thing since the current css definitions are really hacks. I hope this helps, Gunnar On Tue, Jul 12, 2016 at 9:10 PM, Liu, Yu (Yu) <[email protected]> wrote: > Hi Dava, > Thanks for your details! > We plan to upload Chinese reference manuals/website > pages/guides/instructions/blogs/articles/… periodically. > We will follow the instructions on the website to register. > > Hi all, > One more question: > China has been growing dramatically and enjoy tremendous potential, in > order to benefit more people and grow more audience, and given that a > wealth of Chinese documentation will be coming, thus could Apache > Trafodion create a specific section/tab for Chinese files? > > Liu Yu > > > -----Original Message----- > From: Dave Birdsall [mailto:[email protected]] > Sent: Wednesday, July 13, 2016 12:18 AM > To: [email protected] > Cc: Jin, Jian (Seth) <[email protected]>; Yang, Yang (Felix) < > [email protected]> > Subject: RE: Chinese Contributor Access > > Hi Liu Yu, > > > > What sort of documentation do you wish to contribute? Wiki pages? Web > site pages? Chinese versions of the reference manuals? > > > > An ICLA is a good idea for all of these. A JIRA ID is also a good idea > for all of these; it is a good mechanism for tracking work. > > > > A Git ID is needed if you are doing web site pages or Chinese versions > of the reference manuals, since the source for both of these is stored > in Github. > > > > Dave > > > > *From:* Liu, Yu (Yu) [mailto:[email protected]] > *Sent:* Monday, July 11, 2016 11:06 PM > *To:* [email protected] > *Cc:* Jin, Jian (Seth) <[email protected]>; Yang, Yang (Felix) < > [email protected]> > *Subject:* Chinese Contributor Access > > > > Hi Apache Trafodion, > > > > Sincerely appreciate your great efforts for Apache Trafodion Community. > > > > I’m Liu Yu who is a technical writer from Esgyn in China (Shanghai), > along with some Chinese volunteers who are eager to get more involved > and want to be contributors to Apache Trafodion Community. > > > > 1. How can we publish Chinese documentations? > > > > 2. Should we register as indicated below (screen short from website) > *individually*? ICLA + Git ID + Jira ID? > > > > > > > > Many thanks! > > > > Liu Yu > -- Thanks, Gunnar *If you think you can you can, if you think you can't you're right.*
