* Fix a bunch of content errors.
- Replace links using https://istio.io and / with {{home}} so they work
on staging and archive versions of the site.
- Fix a bunch of preformatted blocks that has extra spaces or incorrect indent
- Replaced usage of "Further reading" with "What's next" to match our convention.
- Fix capitalization style of various headers to match our convention.
- Broke up some preformatted blocks to separate the command-line from the output
in order to make cut & paste easier, per our convention.
* Fix more links.
* Update reference docs.
- We now replace instances of https://istio.io with {{site.baseurl}} in imported
reference docs such that the generated site will work properly for staging and for
archive.istio.io
* Fix a bad link.
* Add documentation for Helm deployment
This adds documentation along with related configuration options for
deploying Istio with the Helm charts.
* Few corrections as suggested during review.
* Fix error in path to install Helm package
* Slight refinement of helm documentation
Fix a typo in the install command and warning clause about automatic
sidecar injection not being implemented.
The documentation change here reflects the work that was done on:
https://github.com/istio/istio/pull/2465
and should only be merged IFF the aforementioned PR is merged
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.
- 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.
- 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.
Handles https://github.com/istio/issues/issues/75.
* Tweak description of how `istio-initializer` behaves.
* Fix wrong initializer name (`status.sidecar.istio.io`).