cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Andrey Kurdumov <kant2...@googlemail.com>
Subject Re: [DOCS] doc or docs subfolder?
Date Tue, 06 Oct 2015 07:33:49 GMT
I think we should explicitly fix that in the docs and samples for
crowdin.yaml.
Right now
https://github.com/apache/cordova-coho/blob/master/docs/doc-translation-process.md
contains ** which pickup the cordova-docs twice. For me right way to manage
is to explicitly specify which repositories we translate. It is a bit
boring to setup initially, but then we could move docs to more appropriate
folder. Maybe rename it to translation in cordova-docs.

Victor work a lot with CrowdIn, so interesting to hear his opinion too.

2015-10-06 13:25 GMT+06:00 Dmitry Blotsky <dblotsky@microsoft.com>:

> Yeah, the “doc” folder contains the docs about the repo, which just
> happens to be the docs repo. In other words, “doc” contains the docs about
> the docs. In the new file structure, “docs” lives under “www”, which
> alleviates some of the confusion.
>
> Kindly,
> Dmitry
>
> > On Oct 5, 2015, at 11:43 PM, Andrey Kurdumov <kant2002@googlemail.com>
> wrote:
> >
> > doc folder comes from the Crowdin translation. I believe this was created
> > in main repository mainly as side-effect of same CrowdIn config file for
> > main docs and plugins.
> > As far as I aware these translation files was not popularized, althrough
> I
> > try translate them, since having our repository rules translated is
> > potentially good for translations efforts.
> >
> > It was present prior translation, but if we rename it to something more
> > meaningful and change CrowdIn settings to not create this folder
> >
> > 2015-10-06 11:18 GMT+06:00 Shazron <shazron@gmail.com>:
> >
> >> Sorry  - that commit does not tell me anything. In that commit I see
> >> files added to "doc" and I see files added to "docs".
> >>
> >> But perusing the files now I see why I was confused: "doc" is the
> >> translation for the README for the repo itself; docs is for the actual
> >> documentation files.
> >>
> >> On Mon, Oct 5, 2015 at 7:05 PM, Carlos Santana <csantana23@gmail.com>
> >> wrote:
> >>> It's docs
> >>>
> >>
> https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fgithub.com%2fapache%2fcordova-docs%2fcommit%2f89be0380ba2a80ccfde1d28387b4ed228e10a9f8&data=01%7c01%7cdblotsky%40microsoft.com%7c81d259c87807441a1a6308d2ce1981e2%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=QM%2fPFD%2fI4a%2bVS%2bDK0YZ7WyiovV1zd1JTpjq1iqwiVA8%3d
> >>>
> >>>
> >>> On Mon, Oct 5, 2015 at 6:08 PM Shazron <shazron@gmail.com> wrote:
> >>>
> >>>>
> https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fgithub.com%2fapache%2fcordova-docs&data=01%7c01%7cdblotsky%40microsoft.com%7c81d259c87807441a1a6308d2ce1981e2%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=SMlPFLoVnrQXjnHN2mF9XihDVwYyeEfp027TkiUu8OI%3d
> >>>>
> >>>> I think "doc" is a remnant of a prior re-factor and can be removed,
> >> maybe?
> >>>>
> >>>> ---------------------------------------------------------------------
> >>>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> >>>> For additional commands, e-mail: dev-help@cordova.apache.org
> >>>>
> >>>>
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> >> For additional commands, e-mail: dev-help@cordova.apache.org
> >>
> >>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> For additional commands, e-mail: dev-help@cordova.apache.org
>

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