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
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.
Christian Posta
Hollin Wilkins
Georgios Andrianakis
Tao Li
patricekrakow
Ross Guarino
Vincent
Vadim Eisenberg
Guang Ya Liu
Martin Taillefer
Laurent Demailly
Julien Senon
Nathan Mittler
Fanghui Qing
Jasmine Jaksic
Jason Yee
Shriram Rajagopalan
Lee Calcote
Dan Ciruli
sudeeptoroy
Jeff Mendoza
Wayne Zhang