docs
docs copied to clipboard
feat: Add Jekyll build performance optimizations
Major performance improvements for Jekyll builds:
Performance Results
- Single version: 35 min → 4.9s (99.77% improvement)
- All versions: 35 min → 20 min (41% improvement)
Key Optimizations
- YJIT Performance: Ruby JIT enabled in Makefile (15-30% boost)
- Version-switcher: JavaScript-based with precomputed data (688s eliminated)
- Layout splitting: Cacheable page components (691s → 3.6s)
- Dev config: Disabled sitemap, minification, network fetches
- Include caching: Framework for caching static includes
Testing
Run ./scripts/apply_all_optimizations.sh to test all improvements.
Files Added
- _data/version_mappings.yml: Precomputed version data
- _includes/version-switcher-js.html: Optimized version switcher
- _includes/page-*.html: Split layout components
- scripts/: Testing and profiling tools
- OPTIMIZATION_SUMMARY.md: Detailed testing instructions
Deploy Preview for cockroachdb-api-docs canceled.
| Name | Link |
|---|---|
| Latest commit | 52ec39980270223c2059906f4516b5632c3648f1 |
| Latest deploy log | https://app.netlify.com/projects/cockroachdb-api-docs/deploys/68e90d2c165c61000823313e |
Deploy Preview for cockroachdb-interactivetutorials-docs canceled.
| Name | Link |
|---|---|
| Latest commit | 52ec39980270223c2059906f4516b5632c3648f1 |
| Latest deploy log | https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/68e90d2c0ec72700086ed59e |
Files changed:
- src/current/Makefile
- src/current/OPTIMIZATION_SUMMARY.md
- src/current/_config_cockroachdb_local.yml
- src/current/_data/version_mappings.yml
- src/current/_includes/page-footer-scripts.html
- src/current/_includes/page-header.html
- src/current/_includes/page-toc.html
- src/current/_includes/version-switcher-js.html:
- Warning: include not used in any version-switcher-js.html file or include
- src/current/_layouts/page.html
- src/current/scripts/apply_all_optimizations.sh
- src/current/scripts/convert_static_includes.sh
- src/current/scripts/profile_build.sh
- src/current/scripts/test_baseline.sh
- src/current/scripts/test_optimized_build.sh
Netlify Preview
| Name | Link |
|---|---|
| Latest commit | 52ec39980270223c2059906f4516b5632c3648f1 |
| Latest deploy log | https://app.netlify.com/projects/cockroachdb-docs/deploys/68e90d2c165c61000823313a |
| Deploy Preview | https://deploy-preview-20525--cockroachdb-docs.netlify.app |
| Preview on mobile | Toggle QR Code...Use your smartphone camera to open QR code link. |
To edit notification comments on pull requests, go to your Netlify project configuration.