I'm resurrecting this topic because I've just created this issue https://issues.apache.org/jira/browse/CB-11414
Are we still using crowdin for the translations, right? What I talk on the issue about marking parts of the docs as hidden to not be translated can only be done by "Project Managers", who are the crowdin project managers? 2016-04-25 18:43 GMT+02:00 Jesse <[email protected]>: > So should we include a en/ folder in all the docs? and move all our current > readme files out of the root? > Personally I am against JSDoc automation, but willing to accept whatever we > decide, but that is another conversation. > > > > @purplecabbage > risingj.com > > On Sat, Apr 23, 2016 at 11:24 PM, Dmitry Blotsky <[email protected] > > > wrote: > > > Ideally, we don’t want that to be the case. Using the README.md file for > > documentation is really inaccessible from both a translation and > usability > > perspective. The README.md should explain how to do basic things for a > > repo, and should provide a link to the documentation site. I think the > > ideal goal is to have the docs site generate JSDoc pages for plugins and > > display them in style with translations and all; once that is possible, I > > think we should remove docs from README.md and encourage people to read > > docs on the site. > > > > Kindly, > > Dmitry > > > > > On Apr 22, 2016, at 6:24 PM, Jesse <[email protected]> wrote: > > > > > > But people also read it at github.com and npmjs.org, at least the > > English versions > > > > > >> On Apr 22, 2016, at 5:56 PM, Dmitry Blotsky <[email protected]> > > wrote: > > >> > > >> I think the plan is to have the docs, as well as their translations, > > live on docs.cordova.io. The docs source is in each plugin's source > code, > > but the formatted and translated output that people should be reading is > on > > the docs website. > > >> > > >> Kindly, > > >> Dmitry > > >> > > >> -----Original Message----- > > >> From: Jesse [mailto:[email protected]] > > >> Sent: Friday, April 22, 2016 5:45 PM > > >> To: [email protected] > > >> Subject: Re: Plugin documentation translations > > >> > > >> Thanks Dmitry and Julio, > > >> So assuming we want devs who go to the github repo to be able to read > > the 'edge' documentation, we just need the README.md there? > > >> The index.md(s) I looked at all seemed to be from an ancient commit, > > so maybe for now we just get rid of those. > > >> > > >> > > >> @purplecabbage > > >> risingj.com > > >> > > >> On Fri, Apr 22, 2016 at 5:24 PM, Dmitry Blotsky < > [email protected] > > > > > >> wrote: > > >> > > >>> From what I understand, the process was to upload the files to > > >>> Crowdin, and then download the translations generated by Crowdin and > > >>> commit them back to the repo. > > >>> > > >>> Now the plugin READMEs are pulled in to the website build, and get > > >>> translated along with it. So, those individual language-specific > files > > >>> in plugin repos shouldn't be necessary anymore. We'll probably > revisit > > >>> this process and clean up once we get to automating the Crowdin > steps. > > >>> > > >>> Kindly, > > >>> Dmitry > > >>> > > >>> -----Original Message----- > > >>> From: julio cesar sanchez [mailto:[email protected]] > > >>> Sent: Friday, April 22, 2016 4:12 PM > > >>> To: [email protected] > > >>> Subject: Re: Plugin documentation translations > > >>> > > >>> As far as I know, the translations are created in crowdin ( > > >>> > > >>> > https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fcrowd > > >>> in.com%2fproject%2fcordova&data=01%7c01%7cdblotsky%40microsoft.com > %7cf > > >>> > 57f3f3186c74e697faa08d36b0387f1%7c72f988bf86f141af91ab2d7cd011db47%7c1 > > >>> &sdata=vD2jpn%2f5F2ccF%2fL1u963dAd22HJoRz75KSnYe7NhhSU%3d > > >>> ) > > >>> It creates the index.md, I have no idea about the README.md. > > >>> > > >>> According to the mails on the list, Victor Sosa was the one taking > > >>> care of it but he didn't have enough time and Andrey Kurdumov took > > >>> over, so maybe he can shed some light. > > >>> > > >>> > > >>> > > >>> > > >>> 2016-04-23 0:30 GMT+02:00 Jesse <[email protected]>: > > >>> > > >>>> First off, I apologize for not being up to date in how we handle > > >>>> translation of plugin docs. > > >>>> Second, I want to thank whoever has been. > > >>>> > > >>>> So, looking thru the docs folder of the device-orientation plugin, I > > >>>> see some very similar files ... each language folder appears to > > >>>> contain an index.md and a README.md which are 'almost' identical. > > >>>> The important part here is the 'almost'. > > >>>> All of which finally brings me to my questions. > > >>>> > > >>>> How are these files created and updated? Why are they different? > > >>>> Where are they shown? > > >>>> > > >>>> Thanks in advance! > > >>>> Cheers, > > >>>> Jesse > > >>>> > > >>>> > > >>>> @purplecabbage > > >>>> risingj.com > > >> > > >> --------------------------------------------------------------------- > > >> To unsubscribe, e-mail: [email protected] > > >> For additional commands, e-mail: [email protected] > > > > > > --------------------------------------------------------------------- > > > To unsubscribe, e-mail: [email protected] > > > For additional commands, e-mail: [email protected] > > > > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [email protected] > > For additional commands, e-mail: [email protected] > > > > >
