cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Andrey Kurdumov <kant2...@googlemail.com>
Subject Re: Thought on improving translation and docs
Date Mon, 05 Jan 2015 23:45:43 GMT
Also, just find out why non-English docs takes more time to generate.
See CB-8248 [1] for explanation.

[1] https://issues.apache.org/jira/browse/CB-8248

2015-01-06 4:53 GMT+06:00 Andrey Kurdumov <kant2002@googlemail.com>:

> Make is good idea. I definitely interested in faster generation time.
> The only reasonable tool for me from JS community is Jake. Gulp and Grunt
> would not provide any additional benefit for my implementation.
> I'm not even sure that Rake would be more maintainable solution then
> implementing logic in the application itself.
>
> With my last improvements for CB-8246. On my PC full generation time went
> down from 1584 sec to 1111 sec. See [1]
>
> Right now the fastest way to improve overall generation time is to chain
> post-processing steps in such way that
> a) cheerio would not parse HTML each step
> b) Intermediate results would not be written to the disk.
> That's hopefully would bring us additional ~20-30% improvements from
> current state.
>
> After that bottleneck would be in joDoc-js, hopefully that's also has
> enough places for improvements.
>
> Maybe after that changes I would be able to regenerate single file, to
> speedup subsequent generation even further.
>
> [1] https://github.com/apache/cordova-docs/pull/253
>
>
> 2015-01-05 22:15 GMT+06:00 Josh Soref <jsoref@blackberry.com>:
>
>> We should consider trying to have Make like rules so that we can avoid
>> rebuilding content if the underlying elements haven't changed…
>>
>> I'm also in favor of trying to share images across things.
>>
>> On 1/5/15, 10:17 AM, "Andrew Grieve" <agrieve@chromium.org> wrote:
>>
>> >Awesome stuff. I'll look at your PR today.
>> >
>> >Only reason I suspected images as a problem is that the docs directory on
>> >the website (http://svn.apache.org/repos/asf/cordova/site/public/) is
>> >currently 773MB. Not great, but I guess not too terrible :P
>> >
>> >On Mon, Jan 5, 2015 at 7:24 AM, Andrey Kurdumov <kant2002@googlemail.com
>> >
>> >wrote:
>> >
>> >> I take measures and find that most of the time is spend inside of
>> >>'Adding
>> >> Title', 'Building TOC' and 'Merging files' step.
>> >> Each of that steps take 3-4 seconds. Other steps takes less then half
>> >>of a
>> >> second.
>> >>
>> >> Average generation time for language is 24 seconds. Upper part of
>> >> distribution is non-English translations.
>> >> Most English docs takes 13-15 seconds to generate.
>> >> Other European languages 20-24 seconds.
>> >> Japanese, Korean and Chinese 25-31
>> >>
>> >> The pull request for the docs generator with timing swtich is
>> >> https://github.com/apache/cordova-docs/pull/252
>> >>
>> >> @Andrew From what I see that static content ~9M is not give us too much
>> >> problem if we not upload everything again after regeneration.
>> >> If uploading only new docs it will be ~100M overhead. I definitely will
>> >>try
>> >> to reduce duplication, but right now it does not give me too much
>> >> pain so I will improve that specific place. Maybe I'm not aware about
>> >>other
>> >> side-effects and processes where this duplication is increased?
>>
>
>

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