Fixes#837
But we need probably some replacement text
We can’t anyway link to master with line numbers, that wasn’t working
even before we deleted the files
Cc @douglas-reid
I made a last minute change to shrink the header height when on mobile,
but I forgot to compensate for that on the home page, which left a white
gap on the screen. Yuck.
Four major themes to this work:
* Performance. This new site is fast. It loads considerably faster, especially on mobile.
Every pixel is drawn exactly once. Clicking around doesn't result in things jiggling everywhere.
* Navigation. I wanted to make it easier to get around the site, especially on mobile. To that end, we now have:
- Sticky navigation elements. The top nav bar, the left sidebar and the right TOC are now sticky and remain
on screen even as page content is scrolled.
- Tabs in the Docs section have been removed and integrated as accordion items in the left sidebar.
* Layout. I moved a bit of content around to make it easier to find and give us some room to grow:
- The Help page is now replaced with a full Help section. This provides a home for the FAQ, glossary,
bug reporting, and troubleshooting pages.
- The About page is now replaced with a full About section. This provides a home for the release notes, roadmap, upcoming "in the news" section, etc.
* Design. I tried to improve consistency across the site and provide a slightly lighter feel by minimizing the impact of some design elements. Specifics:
- Font sizes are now consistent across the site.
- The site does a much better job at adjusting to different screen sizes which makes the mobile experience better.
- Accessibility is improved by adding many attributes for screen readers, and by ensuring the site scales properly based on user-selected fonts.
* Update feature-stages.md
Adding redirect from https://istio.io/docs/reference/feature-stages.html.
I understand the content needs to be updated but that's orthogonal to fixing a broken link.
* Update feature-stages.md
fixing redirects
- Slightly update the section index files. This is to make some upcoming
future work easier. These changes have no practical effect on the current
site.
- Delete a few extraneous files I noticed.
figure.html now contains a bit of magic to substantially improve
the load time and visual appearance of pages that contain imagery.
The magic pre-allocates space on the page of the exact size needed
for the image, even though the image isn't loaded yet. The result
is that the page can be layed out once, layout doesn't need to
happen again for each image that gets loaded.
- The latest_blog_post variable is now computed instead of
needing to be set explicitly when a new post is added.
- FAQ categories are now specified in a much denser format directly
in the FAQ markdown rather than with a bunch of files.
- We no longer have a redirect from the top-nav Blog link to the
current latest blog post, which looks nicer.
- Added a link to our team drive to the community page.
- Upgrade a few icons from PNG to SVG
- Reintroduce content compression which I accidentally left turned off previously.
- Reintroduce the RSS icon on blog posts which disappeared in last week's great blog
page redesign.
- Update doc contribution guide to cover blog posts and setup pages.
- Add templates for setup topics and blog posts.
- Compress our SVG files for faster loading.