You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cordova.apache.org by Lisa Seacat DeLuca <ld...@us.ibm.com> on 2014/03/04 16:38:12 UTC
translation scripts on github
I think it'd be a good idea to put the crowdin/cordova translation scripts
somewhere on github so they are there in case someone else needs to run
them besides me. I uploaded them to one of my github repos here:
https://github.com/ldeluca/cordova-translation Any suggestions for a good
place to put them inside of the cordova github repos? Maybe coho?
Instructions on how to run the translation scripts are also on our wiki
page here: http://wiki.apache.org/cordova/CordovaTranslations.
Lisa Seacat DeLuca
Mobile Engineer | t: +415.787.4589 | ldeluca@apache.org | |
ldeluca@us.ibm.com | lisaseacat.com | |
Re: translation scripts on github
Posted by Michael Brooks <mi...@michaelbrooks.ca>.
>
> I think it would be good to have code and doc married :-)
I agree Carlos! I've always felt strongly that a project's documentation
should be under version control with the source code. This strong marriage
ensures that, oh say the wiki server vanishes, we will still know how to
compile the project's source code. The wiki should only be used to document
processes between multiple projects. Unfortunately, I've been in the
minority on this view for years.
On Tue, Mar 4, 2014 at 2:18 PM, Carlos Santana <cs...@gmail.com> wrote:
> I also think they should go in cordova-docs repo
>
> And Also I would transfer the Wiki Page Instructions into Repo as README.md
> on the root with those scripts.
>
> I think it would be good to have code and doc married :-)
>
> Also long term maintenance is easier for folks to contribute to the
> instructions in github via pull request
> So if someone update the script and instructions need to be update they can
> do it all in one pull request
>
>
>
>
> On Tue, Mar 4, 2014 at 12:27 PM, Michael Brooks <michael@michaelbrooks.ca
> >wrote:
>
> > I think the translation scripts can go under cordova-docs as well.
> Perhaps
> > `lib/translation/`. If you have an entry-point executable, then place it
> > under `bin/translation`. That keeps everything organized and following
> the
> > same pattern as the generator script.
> >
> > For the plugin documentation, ideally we'll follow the same pattern as
> > before: `cordova-plugin-name/doc/LANG/`. Perhaps we can make English the
> > root (no "en" directory) to make viewing easier for non-translated
> plugins
> > (e.g. third-party plugins). *shrugs*
> >
> >
> > On Tue, Mar 4, 2014 at 9:05 AM, Lisa Seacat DeLuca <ldeluca@us.ibm.com
> > >wrote:
> >
> > > Thats an idea (re: put inside cordova-docs). Reason I didn't suggest
> it
> > > was the plugin docs are in their own repos now. But that doesn't mean
> > the
> > > scripts can't be in cordova-docs. We could have a new directory for
> > > translation scripts, not to be confused with "translations are under
> this
> > > dir". Sure, we can add to the agenda. I'll be on in listen only
> mode. I
> > > have a conflict for the 2nd half of the hangout. We should also talk
> > about
> > > how we're going to handle pointing to the plugin documentation on the
> > call
> > > as well. Right now it redirects to the github repos which is going to
> be
> > > try with version switching and translations.
> > >
> > > Lisa Seacat DeLuca
> > > Mobile Engineer | t: +415.787.4589 | *ldeluca@apache.org*<
> > ldeluca@apache.org>| |
> > > *ldeluca@us.ibm.com* <ld...@us.ibm.com> | *lisaseacat.com*<
> > http://www.lisaseacat.com/>| [image:
> > > follow @LisaSeacat on twitter] <http://www.twitter.com/LisaSeacat>|
> > [image:
> > > follow Lisa Seacat DeLuca on linkedin]<
> > http://www.linkedin.com/in/lisaseacat>
> > >
> > >
> > >
> > >
> > >
> > > From: Brian LeRoux <b...@brian.io>
> > > To: "dev@cordova.apache.org" <de...@cordova.apache.org>
> > > Date: 03/04/2014 11:31 AM
> > > Subject: Re: translation scripts on github
> > > Sent by: brian.leroux@gmail.com
> > > ------------------------------
> > >
> > >
> > >
> > > These could live in a branch on cordova-labs repo but it seems to me
> this
> > > would belong in cordova-docs, no?
> > >
> > > (Should we add this to this afternoon's agenda for the hangout?)
> > >
> > >
> > > On Tue, Mar 4, 2014 at 7:38 AM, Lisa Seacat DeLuca <ldeluca@us.ibm.com
> > > >wrote:
> > >
> > > > I think it'd be a good idea to put the crowdin/cordova translation
> > > scripts
> > > > somewhere on github so they are there in case someone else needs to
> run
> > > > them besides me. I uploaded them to one of my github repos here:
> > > > https://github.com/ldeluca/cordova-translation Any suggestions for
> a
> > > > good place to put them inside of the cordova github repos? Maybe
> coho?
> > > >
> > > > Instructions on how to run the translation scripts are also on our
> wiki
> > > > page here: http://wiki.apache.org/cordova/CordovaTranslations.
> > > >
> > > > Lisa Seacat DeLuca
> > > > Mobile Engineer | t: +415.787.4589 | *ldeluca@apache.org*<
> > > ldeluca@apache.org>| |
> > > > *ldeluca@us.ibm.com* <ld...@us.ibm.com> | *lisaseacat.com*<
> > > http://www.lisaseacat.com/>| [image:
> > > > follow @LisaSeacat on twitter] <http://www.twitter.com/LisaSeacat>|
> > > [image:
> > > > follow Lisa Seacat DeLuca on linkedin]<
> > > http://www.linkedin.com/in/lisaseacat>
> > > >
> > > >
> > >
> > >
> >
>
>
>
> --
> Carlos Santana
> <cs...@gmail.com>
>
Re: translation scripts on github
Posted by Carlos Santana <cs...@gmail.com>.
I also think they should go in cordova-docs repo
And Also I would transfer the Wiki Page Instructions into Repo as README.md
on the root with those scripts.
I think it would be good to have code and doc married :-)
Also long term maintenance is easier for folks to contribute to the
instructions in github via pull request
So if someone update the script and instructions need to be update they can
do it all in one pull request
On Tue, Mar 4, 2014 at 12:27 PM, Michael Brooks <mi...@michaelbrooks.ca>wrote:
> I think the translation scripts can go under cordova-docs as well. Perhaps
> `lib/translation/`. If you have an entry-point executable, then place it
> under `bin/translation`. That keeps everything organized and following the
> same pattern as the generator script.
>
> For the plugin documentation, ideally we'll follow the same pattern as
> before: `cordova-plugin-name/doc/LANG/`. Perhaps we can make English the
> root (no "en" directory) to make viewing easier for non-translated plugins
> (e.g. third-party plugins). *shrugs*
>
>
> On Tue, Mar 4, 2014 at 9:05 AM, Lisa Seacat DeLuca <ldeluca@us.ibm.com
> >wrote:
>
> > Thats an idea (re: put inside cordova-docs). Reason I didn't suggest it
> > was the plugin docs are in their own repos now. But that doesn't mean
> the
> > scripts can't be in cordova-docs. We could have a new directory for
> > translation scripts, not to be confused with "translations are under this
> > dir". Sure, we can add to the agenda. I'll be on in listen only mode. I
> > have a conflict for the 2nd half of the hangout. We should also talk
> about
> > how we're going to handle pointing to the plugin documentation on the
> call
> > as well. Right now it redirects to the github repos which is going to be
> > try with version switching and translations.
> >
> > Lisa Seacat DeLuca
> > Mobile Engineer | t: +415.787.4589 | *ldeluca@apache.org*<
> ldeluca@apache.org>| |
> > *ldeluca@us.ibm.com* <ld...@us.ibm.com> | *lisaseacat.com*<
> http://www.lisaseacat.com/>| [image:
> > follow @LisaSeacat on twitter] <http://www.twitter.com/LisaSeacat>|
> [image:
> > follow Lisa Seacat DeLuca on linkedin]<
> http://www.linkedin.com/in/lisaseacat>
> >
> >
> >
> >
> >
> > From: Brian LeRoux <b...@brian.io>
> > To: "dev@cordova.apache.org" <de...@cordova.apache.org>
> > Date: 03/04/2014 11:31 AM
> > Subject: Re: translation scripts on github
> > Sent by: brian.leroux@gmail.com
> > ------------------------------
> >
> >
> >
> > These could live in a branch on cordova-labs repo but it seems to me this
> > would belong in cordova-docs, no?
> >
> > (Should we add this to this afternoon's agenda for the hangout?)
> >
> >
> > On Tue, Mar 4, 2014 at 7:38 AM, Lisa Seacat DeLuca <ldeluca@us.ibm.com
> > >wrote:
> >
> > > I think it'd be a good idea to put the crowdin/cordova translation
> > scripts
> > > somewhere on github so they are there in case someone else needs to run
> > > them besides me. I uploaded them to one of my github repos here:
> > > https://github.com/ldeluca/cordova-translation Any suggestions for a
> > > good place to put them inside of the cordova github repos? Maybe coho?
> > >
> > > Instructions on how to run the translation scripts are also on our wiki
> > > page here: http://wiki.apache.org/cordova/CordovaTranslations.
> > >
> > > Lisa Seacat DeLuca
> > > Mobile Engineer | t: +415.787.4589 | *ldeluca@apache.org*<
> > ldeluca@apache.org>| |
> > > *ldeluca@us.ibm.com* <ld...@us.ibm.com> | *lisaseacat.com*<
> > http://www.lisaseacat.com/>| [image:
> > > follow @LisaSeacat on twitter] <http://www.twitter.com/LisaSeacat>|
> > [image:
> > > follow Lisa Seacat DeLuca on linkedin]<
> > http://www.linkedin.com/in/lisaseacat>
> > >
> > >
> >
> >
>
--
Carlos Santana
<cs...@gmail.com>
Re: translation scripts on github
Posted by Michael Brooks <mi...@michaelbrooks.ca>.
I think the translation scripts can go under cordova-docs as well. Perhaps
`lib/translation/`. If you have an entry-point executable, then place it
under `bin/translation`. That keeps everything organized and following the
same pattern as the generator script.
For the plugin documentation, ideally we'll follow the same pattern as
before: `cordova-plugin-name/doc/LANG/`. Perhaps we can make English the
root (no "en" directory) to make viewing easier for non-translated plugins
(e.g. third-party plugins). *shrugs*
On Tue, Mar 4, 2014 at 9:05 AM, Lisa Seacat DeLuca <ld...@us.ibm.com>wrote:
> Thats an idea (re: put inside cordova-docs). Reason I didn't suggest it
> was the plugin docs are in their own repos now. But that doesn't mean the
> scripts can't be in cordova-docs. We could have a new directory for
> translation scripts, not to be confused with "translations are under this
> dir". Sure, we can add to the agenda. I'll be on in listen only mode. I
> have a conflict for the 2nd half of the hangout. We should also talk about
> how we're going to handle pointing to the plugin documentation on the call
> as well. Right now it redirects to the github repos which is going to be
> try with version switching and translations.
>
> Lisa Seacat DeLuca
> Mobile Engineer | t: +415.787.4589 | *ldeluca@apache.org*<ld...@apache.org>| |
> *ldeluca@us.ibm.com* <ld...@us.ibm.com> | *lisaseacat.com*<http://www.lisaseacat.com/>| [image:
> follow @LisaSeacat on twitter] <http://www.twitter.com/LisaSeacat>| [image:
> follow Lisa Seacat DeLuca on linkedin]<http://www.linkedin.com/in/lisaseacat>
>
>
>
>
>
> From: Brian LeRoux <b...@brian.io>
> To: "dev@cordova.apache.org" <de...@cordova.apache.org>
> Date: 03/04/2014 11:31 AM
> Subject: Re: translation scripts on github
> Sent by: brian.leroux@gmail.com
> ------------------------------
>
>
>
> These could live in a branch on cordova-labs repo but it seems to me this
> would belong in cordova-docs, no?
>
> (Should we add this to this afternoon's agenda for the hangout?)
>
>
> On Tue, Mar 4, 2014 at 7:38 AM, Lisa Seacat DeLuca <ldeluca@us.ibm.com
> >wrote:
>
> > I think it'd be a good idea to put the crowdin/cordova translation
> scripts
> > somewhere on github so they are there in case someone else needs to run
> > them besides me. I uploaded them to one of my github repos here:
> > https://github.com/ldeluca/cordova-translation Any suggestions for a
> > good place to put them inside of the cordova github repos? Maybe coho?
> >
> > Instructions on how to run the translation scripts are also on our wiki
> > page here: http://wiki.apache.org/cordova/CordovaTranslations.
> >
> > Lisa Seacat DeLuca
> > Mobile Engineer | t: +415.787.4589 | *ldeluca@apache.org*<
> ldeluca@apache.org>| |
> > *ldeluca@us.ibm.com* <ld...@us.ibm.com> | *lisaseacat.com*<
> http://www.lisaseacat.com/>| [image:
> > follow @LisaSeacat on twitter] <http://www.twitter.com/LisaSeacat>|
> [image:
> > follow Lisa Seacat DeLuca on linkedin]<
> http://www.linkedin.com/in/lisaseacat>
> >
> >
>
>
Re: translation scripts on github
Posted by Lisa Seacat DeLuca <ld...@us.ibm.com>.
Thats an idea (re: put inside cordova-docs). Reason I didn't suggest it
was the plugin docs are in their own repos now. But that doesn't mean the
scripts can't be in cordova-docs. We could have a new directory for
translation scripts, not to be confused with "translations are under this
dir". Sure, we can add to the agenda. I'll be on in listen only mode. I
have a conflict for the 2nd half of the hangout. We should also talk
about how we're going to handle pointing to the plugin documentation on
the call as well. Right now it redirects to the github repos which is
going to be try with version switching and translations.
Lisa Seacat DeLuca
Mobile Engineer | t: +415.787.4589 | ldeluca@apache.org | |
ldeluca@us.ibm.com | lisaseacat.com | |
From: Brian LeRoux <b...@brian.io>
To: "dev@cordova.apache.org" <de...@cordova.apache.org>
Date: 03/04/2014 11:31 AM
Subject: Re: translation scripts on github
Sent by: brian.leroux@gmail.com
These could live in a branch on cordova-labs repo but it seems to me this
would belong in cordova-docs, no?
(Should we add this to this afternoon's agenda for the hangout?)
On Tue, Mar 4, 2014 at 7:38 AM, Lisa Seacat DeLuca
<ld...@us.ibm.com>wrote:
> I think it'd be a good idea to put the crowdin/cordova translation
scripts
> somewhere on github so they are there in case someone else needs to run
> them besides me. I uploaded them to one of my github repos here:
> https://github.com/ldeluca/cordova-translation Any suggestions for a
> good place to put them inside of the cordova github repos? Maybe coho?
>
> Instructions on how to run the translation scripts are also on our wiki
> page here: http://wiki.apache.org/cordova/CordovaTranslations.
>
> Lisa Seacat DeLuca
> Mobile Engineer | t: +415.787.4589 |
*ldeluca@apache.org*<ld...@apache.org>| |
> *ldeluca@us.ibm.com* <ld...@us.ibm.com> | *lisaseacat.com*<
http://www.lisaseacat.com/>| [image:
> follow @LisaSeacat on twitter] <http://www.twitter.com/LisaSeacat>|
[image:
> follow Lisa Seacat DeLuca on linkedin]<
http://www.linkedin.com/in/lisaseacat>
>
>
Re: translation scripts on github
Posted by Brian LeRoux <b...@brian.io>.
These could live in a branch on cordova-labs repo but it seems to me this
would belong in cordova-docs, no?
(Should we add this to this afternoon's agenda for the hangout?)
On Tue, Mar 4, 2014 at 7:38 AM, Lisa Seacat DeLuca <ld...@us.ibm.com>wrote:
> I think it'd be a good idea to put the crowdin/cordova translation scripts
> somewhere on github so they are there in case someone else needs to run
> them besides me. I uploaded them to one of my github repos here:
> https://github.com/ldeluca/cordova-translation Any suggestions for a
> good place to put them inside of the cordova github repos? Maybe coho?
>
> Instructions on how to run the translation scripts are also on our wiki
> page here: http://wiki.apache.org/cordova/CordovaTranslations.
>
> Lisa Seacat DeLuca
> Mobile Engineer | t: +415.787.4589 | *ldeluca@apache.org*<ld...@apache.org>| |
> *ldeluca@us.ibm.com* <ld...@us.ibm.com> | *lisaseacat.com*<http://www.lisaseacat.com/>| [image:
> follow @LisaSeacat on twitter] <http://www.twitter.com/LisaSeacat>| [image:
> follow Lisa Seacat DeLuca on linkedin]<http://www.linkedin.com/in/lisaseacat>
>
>