You are viewing a plain text version of this content. The canonical link for it is here.

Posted to oak-issues@jackrabbit.apache.org by "Marcel Reutegger (JIRA)" <ji...@apache.org> on 2018/07/09 07:48:00 UTC

[jira] [Created] (OAK-7615) Speed up site generation

Marcel Reutegger created OAK-7615:
-------------------------------------

             Summary: 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
             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)