- Link injection for document headers has been broken for a while due to my
misunderstanding of the "for in" syntax in JavaScript. This now works as expected.
- Same problem also prevented the feature that causes every link to outside of istio.io
to be opened in a separate window. This now works as intended.
- Made the gear dropdown menu be right-aligned such that it doesn't go off-screen on
portrait mode tablets.
- Stop importing Popper.js since it's only needed for dropdown menus that aren't in the
nav bar. Ours is in a nav bar...
- Added link injection for <dt> terms, which makes it easy to create links to individual glossary entries.
- Fix another issue with my arch-nemesis, the Copy button. My last fix for Copy button issues
resulted in screen flickering upon page loading. This is now fixed.
- Pin the size of the gear and magnifying glass icons in the header to avoid flicker as the
fonts for those renders a few ms too late and lead to flickering on page load.
- Cleaned up the site's JavaScript for clarity, and include minimized versions in the
site for improved perf.
- We now automatically detect when a TOC has no entries in it and omit the spacing on the right side
for the TOC. This improves the formatting of a few pages on the site.
- Make an another attempt at preventing the dropdown arrow from wrapping under the cog on smaller screens.
This new solution seems to work across several browsers I've tried.
- Remove an extraneous header in one page.
- Add support for showing the archive date in the footer.
- Fix invalid HTML in the header which improves the responsive layout. In particular, the down arrow
for the dropdown menu tends to stay on the same line as the cog more than before.
- Tone down the blue color of links so it's not so intense. There's still good contrast
between links and normal text.
- Remove broken og:image meta tag from each page. It used to point to a logo.png
file, which we deleted months ago. Turns out it's not intended for web site logos
anyway.
- Add og:url and og:site_name per best practices.
- Remove one more stray border on the community page. I thought I got rid of 'em last time,
but I missed one.
* Add support for a dark color themes.
- The version dropdown is now replaced with a gear dropdown. This dropdown lets you
pick the version of the site to look at, and lets you pick the light or dark color
themes for the site.
- Fixed a rendering glitch on the community page where a stray right and bottom border
was rendered.
- Stop using the prism functionality for syntax highlighting since
it doesn't handle embedded links in <pre> blocks, which prevents
cross-linking to type names properly. We now roll our own PRE block
handling.
- Stop drawing a box around inline code elements which substantially improves
the visuals, especially in tables.
- Improve appearance of tables to be a bit cleaner.
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.
- 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.
- The blog page now has a sidebar showing all blog posts.
- Blog entries now cleanly display the publication date, attribution, and subtitle
- Sidebar entries, both for blog posts and for docs now show tooltips when hovering the mouse over the entry.
This finally gives a home to oddball things like the FAQ, Glossary,
Release notes, and Contributing to the Docs stuff.
Took the opportunity to do a bit of tidying up in the directory structure
of the site by removing useless subdirectories.
- I left a debugging string ("Chevron") in the text, which
would show up on screen. Oops.
- The trick I used to glue the footer to the bottom of the browser window ended up causing trouble with the
vertical scroll bar positioning. I reverted this trick, in favor of a simpler approach. Instead of gluing
the footer to the bottom of the window, I simply make it so the bottom of the page is already rendered in the
same blue as the footer.
- Move a script from loading in the header to loading in the body. According to the Chrome profiler, this
saves a bunch of time blocking rendering during page load.
- Remove unreferenced files
- Stop using sitemap_exclude in front matter since nothing is looking at this.
- Minify the javascript files for faster loading.
- Cleanup and add favicons
- Fill some of the app manifests for Android and Windows to integrate more nicely.
- Address a few Lighthouse auditing issues.
- istio.io/help now brings up a help page which groups together all the things users can do when
they need help.
- Replaced the FAQ link in the top right of each page with a Help link instead
- Did a bit of cleanup in the page footer content & naming
- Whenever there isn't much page content, the page footer is now glued to the bottom of the visible browser page instead
of floating like a fool in the middle of the page/screen.
- Fix clickable region in new FAQ page. Instead of just being able to click on the words, you can now click
on the whole heading area to expand it.
- Better aesthetics.
- Can now navigate by clicking on a letter selector.
- Each word can now be linked to directly (although discoverability
could be better)
- The glossary is now referenced from the header.
- You can now find the glossary at istio.io/glossary
- The FAQ page now has categories to make the page more scalable.
- Removed the FAQ pages that were added a little while ago and integrate
their content into the main site FAQ page.
- Stop computing sitemap.xml since there's a Jekyll plugin that does that
for us.
- Also a few fixes in other FAQ entries.
- Force the right-hand scrollbar on, which eliminates the very annoying left/right jiggle that
was happening whenever loading a new page on istio.io.
- The welcome screen now uses the same layout as all the non-docs pages so it looks more
'normal'
- The TOC's right margin has been shrunk to be consistent with the left margin.
- The community page now uses the color Twitter and GitHub images.
- Move a few things around to maintain order in the web site support stuff.
- Use different rendering style for code blocks.
- Define a default language so stuff always looks right.
- Add a bit more info to the writing-a-topic guide.
* remove manual setting of sidebar height and shift border to content container. refactor
* fix size of copy button font and move button above code blocks
Martin Taillefer
Laurent Demailly
Shriram Rajagopalan
mtail
ryangrahamnc
Varun Talwar
Dave