When on mobile, the left sidebar is hidden by default. To make navigation easier, we allow the user to browse
the site entirely through the various index sections which provide links to all articles. This wasn't working
for the About and Blog links at the top of the page since they send you to a direct page instead of to the
relevant navigation page. So...
- Made the About link point to the about section's index page.
- Each blog page now contains a link to the next and previous blog post.
- 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.
This makes it so documents in the same directory get sorted by document title instead of
by the URL name (unless they have an order: directive, which takes precedence over alpha
order)
- 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.
The Google Crawl Engine reported a bunch of broken links pointing into istio.io.
This adds redirects so that these links work.
Add a hack such that the gear menu logic that lets you time travel through versions
of the site will insist that if a page existed in a given version, it must also exist
in subsequent versions. This will ensure we always create redirects when we move site
content, and thus avoid breaking links into the site. If a page is moved or removed,
this will lead to rake test errors when checking the content of archive.istio.io.
- 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.
- When you hover over an HTML header, we now pop up a link icon holding a link to the
header. Useful to support deep linking to a header.
- When you click on a link that points outside of istio.io, the target is now
opened in a separate tab.
- Improved the coloring of links in the light theme so they're more visible. I was almost not able to
see the difference between normal text and links, now the color delta is greater. Additionally, when
you hover on a link, we now draw an underline.
- Change the color of H1 headers to be black instead of being the same color
as links. They're not links, they shouldn't be that color.
* 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.
* added initial version of Egress HTTPS blog, including adding blog section for 2018
* replace dash with comma
* that has Istio installed -> with Istio installed
* route rule -> Route Rule
* app -> application
* restructured error propagation
* could have gone wrong -> might have gone wrong
* which -> that
* the same -> the previous
* moved "now" after "accessing"
* rephrased "the previous error..."
* rewrote the passage about dynamically defined egress rules, marked some terms in bold
* rephrased "written or configured differently"
* IP -> destination IP
* removed "to secure Egress Rules"
* "to add applying" -> "to enable applying"
* rephrased the passage about no tracing, telemetry, mixer checks
* checkss -> checks, tracing/telemetry -> tracing, telemetry
* logging -> tracing
* rephrased the conclusion section
* e.g -> for example
* added "currently" to "Istio cannot perform filtering"
* allow Istio perform -> allow Istio to perform
* "true" string -> _"true"_
* "Egress Rule" is, it enables -> "Egress Rules" are, they enable, just -> only
* rewrote the sentence about the malicious attack
* ... Mixer checks -> ... Mixer checks for the egress traffic
* updated the date to be 26-th of January
* App -> Application
* cluster -> Kubernetes cluster
* added graceful service degradation
* BookInfo -> Bookinfo
* BookInfo -> Bookinfo in a second place
* Book Details displayed without error -> Book Details displayed correctly
* The issues -> Issues
* no Mixer Checks -> No Mixer Checks in section's title
* on the egress traffic -> for the egress traffic
* on the egress traffic -> for the egress traffic, in the second place
* we achieve -> we have
* added Envoy proxy in parenthesis when talking about Istio sidecar proxy
* completed the https from the app diagram, inside/outside of Istio
* added a figure with HTTPS traffic, from inside/outside of Istio
* added a paragraph about the HTTPS traffic figure
* added a paragraph about the port 443
* added "differently," after configured
* replaced places of "from inside" and "from outside"
since "from outside" appears first on the diagram
* container spec -> the `container` spec
* fixed two links
* moved "to external services" after "traffic"
* the Istio Service Mesh -> an Istio Service Mesh
* traffic between the proxy -> traffic between the pod
* the Istio Service Mesh -> an Istio Service Mesh
* has/have to -> must
* the microservice code -> the code of the microservices
* inside/outside of -> inside/outside
* outside of -> outside (removed of)
* Egress Requests -> egress requests
* added derived from the URL's schema
* URL -> URI, added (https://)
* remove .DS_Store, submitted accidentially
* to outside the cluster -> to destinations outside the cluster
* made "block all the traffic to destinations outside the cluster"
* extended the example about the wildcard match of Egress Rules
www.googleapis.com and fcm.googleapis.com
* replaced "now" with "after deleting the Egress Rule"
* fixed calculating the latest blog, thanks to Martin Teillefer
* removed using istio initializer, since starting from 0.5.0 it requires Kubernetes 1.9
* added mentioning of the Istio version for this blog post
* updated the date to be 31 January 2018
* added mentioning that the example work with or without mTLS
* added a sub-section on a relation to Istio Mutual TLS
* Added: The TLS origination for the external services will work, whether the Istio mutual TLS is enabled or not.
* fixed a link to Egress Rules reference
* added a migration use cases for external services
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.
- 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.
- 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.
- 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
* Point to 0.1 archive of docs and site version fixes
Point to 0.1 archive of docs and site version fixes:
site.data.istio.version was used where it should be hardcoded to 0.1
(like in “our first release was …”) and vice versa (like in the footer)
There isn’t really a navigation (as I don’t know how to do that) but at
least the docs/welcome page points to 0.1
* add build scripts to be driven thru jenkins
* uniformly handle site.baseurl
* data-src should use full paths for now
* update build with version tag
* Add explanation re: CORS
* remove gitmodules
most questions on stackoverflow are support questions better suited for the mailing list or the issues
(people will still be able to reach so from community/)
- 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.
Martin Taillefer
Vadim Eisenberg
Laurent Demailly
Shriram Rajagopalan
mtail
mandarjog
ryangrahamnc