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