Hi Carol, We have a small Chinese translation team(5~7 developers), are translating 《Trafodion Client Installation Guide》,《Trafodion Command Interface Guide》《Trafodion JDBC Type 4 Programmer Reference Guide》to Chinese Version.
theseus yang 2016-07-16 2:12 GMT+08:00 Carol Pearson <[email protected]>: > Do we have a Chinese translation of the Contributor Guide, tested and > validated by one of our current Chinese contributors? If not, that sounds > like the first place to start. > > -Carol P. > > --------------------------------------------------------------- > Email: [email protected] > Twitter: @CarolP222 > --------------------------------------------------------------- > > On Fri, Jul 15, 2016 at 8:19 AM, Gunnar Tapper <[email protected]> > wrote: > > > Hi Felix, > > > > The documentation is part of the source code. You need to set up a build > > environment and use the structure in the docs directory to build/create a > > new document. > > > > So, the "click a button to upload a document" consists of the same steps > as > > you do to upload code; that is, you modify and build source files and > then > > you submit your changes via git, which are then reviewed and merged in > by a > > committer. The documents are written in asciidoc and follow the > > organization and build structure that already exist in the different > > subdirectories in the docs directory. > > > > I hope this helps, > > > > Gunnar > > > > On Fri, Jul 15, 2016 at 4:09 AM, Yang, Yang (Felix) <[email protected]> > > wrote: > > > > > Hi there， > > > The cwiki link about document submission is horrible. It doesn't show > > > people how to put their 1st article online. I'm sure there is a button > > > hidden somewhere for doc contributors to upload their article, or to > > create > > > directories, but I just can't find it. > > > > > > Here is what we suggest how the Chinese translations could be > submitted , > > > just to start discussion: > > > Step 1: Shall we set up a new button/tab "中文“（Chinese) on document > page, > > > http://trafodion.apache.org/documentation.html, on the blue bar, > behind > > > "1.3.0 Release"; > > > Please find the "中文" in the enclosed screenshot ("Trafodion Chinese > > > tab.jpg"); > > > > > > Step 2: > > > We could give a couple of Chinese contributors write privileges, > starting > > > with translations. Now We have a Chinese wechat group on Trafodion, > > fellow > > > Chinese contributors, please send an email to this list or to > > > [email protected] to join the wechat group if you like. > > > > > > Step 3: > > > Upload the translation. Where is the button? is there an interface > like > > > in the attachment "submission page" ? No, I'm not suggestion > submitting > > to > > > cwiki, but just the nice friendly interface to upload like that. > > > > > > To start with, all submissions in Chinese are translations from > "Latest" > > > tab only. The order will be exactly the same. > > > > > > Best, > > > Felix > > > > > > > > > -----Original Message----- > > > From: Gunnar Tapper [mailto:[email protected]] > > > Sent: Friday, July 15, 2016 3:05 AM > > > To: [email protected] > > > Subject: Re: Chinese Contributor Access > > > > > > Hi, > > > > > > Start here: > > > > > > https://cwiki.apache.org/confluence/display/TRAFODION/Modify+Documentation > > > > > > Gunnar > > > > > > On Thu, Jul 14, 2016 at 8:02 AM, Liu, Yu (Yu) <[email protected]> wrote: > > > > > > > Hi all, > > > > Thanks for your suggestion! > > > > We will find a way which serves best. > > > > > > > > Hi Dave & Gunnar, > > > > Currently we have some Chinese guides. > > > > How can we upload/put these files to Apache Trafodion website? > > > > > > > > Many thanks! > > > > Liu Yu > > > > > > > > > > > > -----Original Message----- > > > > From: Eric Owhadi [mailto:[email protected]] > > > > Sent: Thursday, July 14, 2016 9:41 PM > > > > To: [email protected] > > > > Subject: RE: add a roadmap page in Trafodion's project page > > > > > > > > +1 on this, > > > > Eric > > > > > > > > -----Original Message----- > > > > From: Liu, Ming (Ming) [mailto:[email protected]] > > > > Sent: Thursday, July 14, 2016 8:35 PM > > > > To: [email protected] > > > > Subject: add a roadmap page in Trafodion's project page > > > > > > > > Hi, all, > > > > > > > > I suggest that Trafodion team should add a 'roadmap' page in the > > > > project's front web page, so users will be clear what to expect in > the > > > future. > > > > It will help decision making in some cases. > > > > > > > > Thanks, > > > > Ming > > > > > > > > -----Original Message----- > > > > From: Jin, Jian (Seth) [mailto:[email protected]] > > > > Sent: Thursday, July 14, 2016 12:26 PM > > > > To: [email protected]; [email protected] > > > > Subject: RE: Chinese Contributor Access > > > > > > > > This would be very user friendly. > > > > > > > > Br, > > > > > > > > Seth > > > > > > > > -----Original Message----- > > > > From: Dave Birdsall [mailto:[email protected]] > > > > Sent: 2016年7月13日 23:20 > > > > To: [email protected]; [email protected] > > > > Subject: RE: Chinese Contributor Access > > > > > > > > Hi, > > > > > > > > The two don't conflict. > > > > > > > > The source for documents can be in directories that mirror the > English > > > > ones. > > > > Which is a good idea because it will be easier to keep them in synch. > > > > > > > > Links on the web pages and in documents on the other hand can go > > > > transparently across Chinese directories. So to an end-user, it is > > > > just as you describe: Click on the Chinese link on the main web page, > > > > then travel to a collection of Chinese pages. Similarly for the > > > documents. > > > > > > > > Dave > > > > > > > > -----Original Message----- > > > > From: Liu, Yu (Yu) [mailto:[email protected]] > > > > Sent: Wednesday, July 13, 2016 3:01 AM > > > > To: [email protected]; [email protected] > > > > Subject: RE: Chinese Contributor Access > > > > > > > > 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-asciid > > > > oc-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.* > > > > > > > > > > > > > > > > -- > > > Thanks, > > > > > > Gunnar > > > *If you think you can you can, if you think you can't you're right.* > > > > > > > > > > > -- > > Thanks, > > > > Gunnar > > *If you think you can you can, if you think you can't you're right.* > > >
