You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cordova.apache.org by Shazron <sh...@gmail.com> on 2015/10/06 00:07:37 UTC
[DOCS] doc or docs subfolder?
https://github.com/apache/cordova-docs
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
Re: [DOCS] doc or docs subfolder?
Posted by Victor Sosa <so...@gmail.com>.
Thanks Carlos for the reminder.
I'm sorry for being away from the community, am having a hell of time in my
project keeping me away from you guys.
Let me give this a look today and will come back with something hopefully
meaningful.
2015-10-06 6:28 GMT-05:00 Carlos Santana <cs...@gmail.com>:
> Sorry about that, I just shared the commit that showed Victor added the
> files with crowding checking and he might know more info about it. I can
> try ping Victor at work
>
> - Carlos
> Sent from my iPhone 6s
>
> > On Oct 6, 2015, at 3:33 AM, Andrey Kurdumov <ka...@googlemail.com>
> wrote:
> >
> > 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 <db...@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 <sh...@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 <cs...@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 <sh...@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
> >>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> For additional commands, e-mail: dev-help@cordova.apache.org
>
>
--
Victor Adrian Sosa Herrera
IBM Software Engineer
Guadalajara, Jalisco
Re: [DOCS] doc or docs subfolder?
Posted by Carlos Santana <cs...@gmail.com>.
Sorry about that, I just shared the commit that showed Victor added the files with crowding checking and he might know more info about it. I can try ping Victor at work
- Carlos
Sent from my iPhone 6s
> On Oct 6, 2015, at 3:33 AM, Andrey Kurdumov <ka...@googlemail.com> wrote:
>
> 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 <db...@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 <ka...@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 <sh...@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 <cs...@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 <sh...@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
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
Re: [DOCS] doc or docs subfolder?
Posted by Andrey Kurdumov <ka...@googlemail.com>.
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 <db...@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 <ka...@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 <sh...@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 <cs...@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 <sh...@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
>
Re: [DOCS] doc or docs subfolder?
Posted by Dmitry Blotsky <db...@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 <ka...@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 <sh...@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 <cs...@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 <sh...@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
Re: [DOCS] doc or docs subfolder?
Posted by Andrey Kurdumov <ka...@googlemail.com>.
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 <sh...@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 <cs...@gmail.com>
> wrote:
> > It's docs
> >
> https://github.com/apache/cordova-docs/commit/89be0380ba2a80ccfde1d28387b4ed228e10a9f8
> >
> >
> > On Mon, Oct 5, 2015 at 6:08 PM Shazron <sh...@gmail.com> wrote:
> >
> >> https://github.com/apache/cordova-docs
> >>
> >> 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
>
>
Re: [DOCS] doc or docs subfolder?
Posted by Shazron <sh...@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 <cs...@gmail.com> wrote:
> It's docs
> https://github.com/apache/cordova-docs/commit/89be0380ba2a80ccfde1d28387b4ed228e10a9f8
>
>
> On Mon, Oct 5, 2015 at 6:08 PM Shazron <sh...@gmail.com> wrote:
>
>> https://github.com/apache/cordova-docs
>>
>> 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
Re: [DOCS] doc or docs subfolder?
Posted by Carlos Santana <cs...@gmail.com>.
It's docs
https://github.com/apache/cordova-docs/commit/89be0380ba2a80ccfde1d28387b4ed228e10a9f8
On Mon, Oct 5, 2015 at 6:08 PM Shazron <sh...@gmail.com> wrote:
> https://github.com/apache/cordova-docs
>
> 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
>
>