jackrabbit-oak-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Marcel Reutegger (JIRA)" <j...@apache.org>
Subject [jira] [Created] (OAK-7615) Speed up site generation
Date Mon, 09 Jul 2018 07:48:00 GMT
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)

Mime
View raw message