trafodion-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Carol Pearson <carol.pearson...@gmail.com>
Subject Re: Chinese Contributor Access
Date Sun, 17 Jul 2016 05:02:07 GMT
Hi Theseus,

Yes, this is very great news!  I was just thinking that translating the
contributors guide would help make it easier for other people to contribute.

-Carol P.

---------------------------------------------------------------
Email:    carol.pearson234@gmail.com
Twitter:  @CarolP222
---------------------------------------------------------------

On Fri, Jul 15, 2016 at 11:26 PM, Yang, Yang (Felix) <yang.yang@esgyn.cn>
wrote:

> Thanks Theseus, for putting an effort and attracting ppl outside esgyn to
> contribute so quickly.
>
> Yang
>
>
>
> 在 yang theseus <theseusyang@gmail.com>,2016年7月16日 下午1:19写道:
>
> 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 <carol.pearson234@gmail.com>:
>
> > 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:    carol.pearson234@gmail.com
> > Twitter:  @CarolP222
> > ---------------------------------------------------------------
> >
> > On Fri, Jul 15, 2016 at 8:19 AM, Gunnar Tapper <tapper.gunnar@gmail.com>
> > 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) <
> yang.yang@esgyn.cn>
> > > 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
> > > > yang.yang@esgyn.cn 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:tapper.gunnar@gmail.com]
> > > > Sent: Friday, July 15, 2016 3:05 AM
> > > > To: dev@trafodion.incubator.apache.org
> > > > 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) <yu.liu@esgyn.cn>
> 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:eric.owhadi@esgyn.com]
> > > > > Sent: Thursday, July 14, 2016 9:41 PM
> > > > > To: dev@trafodion.incubator.apache.org
> > > > > Subject: RE: add a roadmap page in Trafodion's project page
> > > > >
> > > > > +1 on this,
> > > > > Eric
> > > > >
> > > > > -----Original Message-----
> > > > > From: Liu, Ming (Ming) [mailto:ming.liu@esgyn.cn]
> > > > > Sent: Thursday, July 14, 2016 8:35 PM
> > > > > To: dev@trafodion.incubator.apache.org
> > > > > 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:Jian.jin@esgyn.cn]
> > > > > Sent: Thursday, July 14, 2016 12:26 PM
> > > > > To: dev@trafodion.incubator.apache.org; tapper.gunnar@gmail.com
> > > > > Subject: RE: Chinese Contributor Access
> > > > >
> > > > > This would be very user friendly.
> > > > >
> > > > > Br,
> > > > >
> > > > > Seth
> > > > >
> > > > > -----Original Message-----
> > > > > From: Dave Birdsall [mailto:dave.birdsall@esgyn.com]
> > > > > Sent: 2016年7月13日 23:20
> > > > > To: dev@trafodion.incubator.apache.org; tapper.gunnar@gmail.com
> > > > > 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:yu.liu@esgyn.cn]
> > > > > Sent: Wednesday, July 13, 2016 3:01 AM
> > > > > To: tapper.gunnar@gmail.com; dev@trafodion.incubator.apache.org
> > > > > 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:tapper.gunnar@gmail.com]
> > > > > Sent: Wednesday, July 13, 2016 11:26 AM
> > > > > To: dev@trafodion.incubator.apache.org
> > > > > Cc: Dave Birdsall <dave.birdsall@esgyn.com>; Jin, Jian (Seth)
<
> > > > > Jian.jin@esgyn.cn>; Yang, Yang (Felix) <yang.yang@esgyn.cn>
> > > > > 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) <yu.liu@esgyn.cn>
> > 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:dave.birdsall@esgyn.com]
> > > > > > Sent: Wednesday, July 13, 2016 12:18 AM
> > > > > > To: dev@trafodion.incubator.apache.org
> > > > > > Cc: Jin, Jian (Seth) <Jian.jin@esgyn.cn>; Yang, Yang (Felix)
<
> > > > > > yang.yang@esgyn.cn>
> > > > > > 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:yu.liu@esgyn.cn]
> > > > > > *Sent:* Monday, July 11, 2016 11:06 PM
> > > > > > *To:* dev@trafodion.incubator.apache.org
> > > > > > *Cc:* Jin, Jian (Seth) <Jian.jin@esgyn.cn>; Yang, Yang
(Felix) <
> > > > > > yang.yang@esgyn.cn>
> > > > > > *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.*
> > >
> >
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message