[
https://issues.apache.org/jira/browse/FLINK-12537?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16841495#comment-16841495
]
Seth Wiesman commented on FLINK-12537:
--------------------------------------
[~jark]
I profiled the build and 99% of the time is spent rendering
`_includes/sidenav.html`. This is because of all the liquid tags to build
custom side navigation for each page. Specifically every time a page is
rendered every other page must be loaded into memory and parsed to build that
navigation. I have a few ideas here.
First of all, there are native c extensions for liquid that should provide some
performance improvements across the board. Secondly, instead of building a
custom side navigation for each page, we should have one that is redenered
client side using javascript.
> Improve Documentation Build Time
> --------------------------------
>
> Key: FLINK-12537
> URL: https://issues.apache.org/jira/browse/FLINK-12537
> Project: Flink
> Issue Type: Improvement
> Components: Documentation
> Reporter: Seth Wiesman
> Assignee: Seth Wiesman
> Priority: Major
>
> Flink documentation today uses Jekyll and heavy use of liquid tags, the time
> to build the docs from scratch is > 3min and incremental updates to a single
> page can still take 5 - 10 seconds.
> This is an umbrella issue to profile the documentation build and improve the
> render times.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
