We now generate the test site into a subdirectory such that we can ensure all
links are correctly using {{home}}, which makes the site work correctly once
archived.
Fixed a bunch of broken cases.
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.
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.
* have a more direct link to download and install
like in 0.1
* reduce the diff
* nvm
* reduce diff
* typo galore
* add back the link to old docs
put it at the end of the page
follow up on #509
* 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
- 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.
* WIP on homepage and new top menu structure. Need to rebase to upstream
* WIP on homepage and new top menu structure. Need to rebase to upstream
* force max height on homepage images
- Fix a number of broken links when viewing on a github staging site.
- Updated highligthing of "Edit this Page" pencil to match what other
buttons use on the site.
- Fixed the rendering of buttons on the landing page to have the proper
rounded corners to match our style.
- Support documents which omit the order: front matter field. Instead
of mysterious failues, they are now processed correctly and an error
message is inserted in the generated HTML to let the author know to
add the missing info.
Martin Taillefer
Laurent Demailly
Shriram Rajagopalan
mtail
Dave