[
https://issues.apache.org/jira/browse/OAK-7615?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16536630#comment-16536630
]
Marcel Reutegger commented on OAK-7615:
---------------------------------------
The maven site plugin moved to flexmark-java, which is also mentioned as a
replacement on the pegdown github page. The site-plugin version configured in
oak-parent uses flexmark-java by default, but oak-parent downgrades the
doxia-module-markdown to 1.7, which still uses pegdown.
> Speed up site generation
> ------------------------
>
> Key: OAK-7615
> URL: https://issues.apache.org/jira/browse/OAK-7615
> Project: Jackrabbit Oak
> Issue Type: Improvement
> Components: doc
> Reporter: Marcel Reutegger
> Assignee: Marcel Reutegger
> Priority: Minor
> Fix For: 1.10
>
>
> Generating the documentation site is rather slow because oak-doc currently
> uses a parser that is not maintained anymore. See:
> https://github.com/sirthias/pegdown/
> The deprecation note also mentions performance issues. My experience shows,
> the parser has difficulties with underscores in words. E.g.
> {{DOCUMENT_NS_BGW_NUM_WRITE_RATE}} is a name for a metric I wanted to
> document. Parsing time seems to increase exponentially the more such names
> appear in a markdown file.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
