JuliaDocs / Documenter.jl

A documentation generator for Julia.

Home Page:https://documenter.juliadocs.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Profiling docs build times

jpfairbanks opened this issue · comments

commented

Is there a way to get out the time to build each page? Either grepping the output for lines like INFO: Build Time ... that had the time to build each page, or a table that prints at the end of the build with all the build times would fine

My packages often have docs that use SciML solvers to run the examples and bad settings for the solver can lead to huge run times where I know that >90% of the time to build the docs is running the examples, but I don't know which pages are holding up the build unless I am watching the logs.

Base testing produces a little table for tests that would be a good design to copy.

Good timing. Maybe you can be the guinea pig for #2521 and see how well that PR works for your use case 🙂

commented

This would be perfect, the block-level profiling is what I really wanted.

commented

Looks like this will meet our needs, an option to roll up the times by page instead of block would be a nice-to-have, but not critical to the utility.