Blueprint: Decrease docs website file size

Created on 7 Nov 2016  路  5Comments  路  Source: palantir/blueprint

I was showing the BP website to a person unfamiliar with it, and (about) 10MB of content ends up being a really heavy initial load. It would be great to reduce this, also I think in general the developer community prefers less-heavy experiences.

Possible ideas:

  • Remove all angular examples from public docs site / move them to a separate page
  • Make sure that all sources (JS/CSS) are appropriately minified
  • Make sure that no duplicate dependencies are getting included
  • Eliminate any extra dependencies that are only being used for a small feature. Or, make sure to use Webpack 2's tree-shaking feature appropriately.
  • Make sure inline source maps aren't included anywhere (#112)
documentation tooling P2 enhancement

Most helpful comment

We fixed #112 already. The Chrome console shows 8 requests and 894KB downloaded (half of that after caching):
image

Still more work to do of course, we'll tackle it as part of version 2.0 when we revamp the docs to include upcoming new projects, in addition to a new landing page which will be more lightweight. Gonna close this one as we've made good progress and next efforts will be focused on 2.0.

All 5 comments

@JKillian are you talking about the docs or the landing? In any case, very valid point! It'd be great to tackle this before shipping, I agree that HN and other devs will be ruthless when it comes to perf.

Side note, if you were talking about the landing, please keep it low key before it's public, I want to keep the surprise 馃巵

Just meant the general docs, but agreed that both should be nice and fast! Yeah, HN hates big websites 馃棥

i don't see us resolving this before shipping, but we can certainly look into it immediately after!

Yes, you should have fixed this before shipping.

We fixed #112 already. The Chrome console shows 8 requests and 894KB downloaded (half of that after caching):
image

Still more work to do of course, we'll tackle it as part of version 2.0 when we revamp the docs to include upcoming new projects, in addition to a new landing page which will be more lightweight. Gonna close this one as we've made good progress and next efforts will be focused on 2.0.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

westrem picture westrem  路  3Comments

havesomeleeway picture havesomeleeway  路  3Comments

havesomeleeway picture havesomeleeway  路  3Comments

sighrobot picture sighrobot  路  3Comments

giladgray picture giladgray  路  3Comments