* Improves multicluster documentation
Improve documentation based upon fresh eyes running through the
documented process.
* Address reviewer comments.
* More refinement.
* Exclude rule MD028
Rule 028 is: https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md#md028---blank-line-inside-blockquote
The rationale below cut and pasted from markdownlint seems
valid for the general case, however, our MD parser always
produces seprate block-quotes, which is what I am after in
this PR. I think other people will prefer our renders of
blockquotes (separate blockquotes);
Rationale: Some markdown parsers will treat two blockquotes
separated by one or more blank lines as the same blockquote,
while others will treat them as separate blockquotes.
- In front matter, order: and overview: are now weight: and description:
- In front matter, we generally don't need layout: and use config to assign layouts automatically
- Remove the useless type: front-matter entries, the type is infered from the file extension.
- When I was last fiddling with the sidenav on mobile, I messed up the sizing for non-mobile cases.
This cause the sidenav to grow beyond its expected size when presented with long non-wrapping page
titles. The text is now wrapped instead as it should.
- Shrank the font size of the list items in the sidenav to 85% to reduce the amount of wrapping that
happens.
- Reduce the right margin in the side nav to again try to reduce the amount of wrapping.
Instead of having to have two PRE blocks, one for commands and one for the output,
we can now have a single PRE block and we take care of rendering things to show the
command vs. the output. The Copy button on such a thing only copy the command, and not
the output.
We now also show a $ on command-lines, but the Copy button doesn't copy that and knows to just
copy the usable part of the command-line.
* adding the recommended namespace
https://github.com/istio/issues/issues/312
* add the recommended namespace
* add creating the namespace
* correct typos
* only need to create namespace
for the template approach
The command as it stands will fail with "Gemfile not found". The working directory should be set to $(pwd) as well to start execution in the istio.github.io directory and find the Gemfile.
* Add a trailing / on an URL that was returning a 301
* Update multicluster intallation to match master
Big usability improvements have been made. Document
the new workflow for multicluster.
* Address reviewer comments.
* Fix linting problem
- The slide-in sidenav used on mobile went all crazy when text got too long in the expanded
panel. We now set a max width to trigger controlled wrapping and avoid the nasties.
- The hamburger menu that replaces the link in the top header on small screens didn't render
right on medium-sized screens (a.k.a. portrait-mode tablets). I had one of my breakpoints set
inconsistently.
- Dynamically loaded PRE blocks were not being syntax colored, now they are.
- The Links endnote section created for printing pages was not dedupping identical
links.
- The Links endnote section contained entries for the next/previous links which are
normally at the bottom of each page. These links aren't visible when printing and so
shouldn't appear in the Links endnote section.
Instead of doing syntax highlighting statically in Jekyll, we now
go back to the PrimsJS library we used in the 0.2-0.4 timeframe.
It used to be problematic, but the cause for the problems have
been addressed a while ago.
This gives us highlighting for non-markdown content,
such as dynamically loaded PRE blocks and PRE blocks that
come from HTML generated from protos.
* Modify minimum pin of Istio version with Helm and improve prereqs
* Add section describing briefly how to use helm without tiller
* Change heading description for Helm method and add upgrade warning
* Make common customization options table match current master
* Subsection the two methods for installing with Helm
* Remove Helm keys from .spelling. Add FQDNs as an acronym.
* Backtick the keys and defaults, values.yaml, and fix 1 spelling error
* Add uninstall instructions for both kubectl and helm with tiller
* Place backticks around architecture platforms and correctly list them
* Show both uninstall methods (kubectl & Helm)
* Remove two extra CRs
* Fix yaml linting errors
* Link to requirements for automatic sidecar injection.
* Change istio-auth to istio for rendering
* Address reviewer comments.
* Fix linting error.
* Notify operator they need capability to install service accounts.
* Fix lint error
- New visuals for the sailboat in the header. It now overflows the header.
- The TOC now highlights the currently displayed portion of the current page.
As you scroll through the doc, the selected entry updates accordingly.
- Add previous/next page links in every doc page. These used to be present only in
blog posts, but they're useful everywhere.
- Fix a few off-by-one formatting errors that stemed from using a mixed of
min-width and max-width throughout the stylesheet. This caused some strange
formatting to happen at specific window widths. Now, we're consistently using
min-width and everything lines up properly.
- Improved footer formatting so it looks better on mobile.
- Only display the TOC on XL screens, otherwise it wraps too much.
Screens smaller than XL now all get the inlined TOC instead.
- Add support for pages to request that the TOC be generated inline instead of in a sidebar.
This is useful for pages that have headings which cause too much wrapping in the TOC,
such as the Troubleshooting Guide.
- Add some blank space between an inlined TOC and the main text so that things don't look
so crowded, especially when printing.
- Inline the sailboat SVG into each page. This avoids a network roundtrip and allows the
SVG to be controlled with the same CSS as everything else.
- Eliminate a huge amount of redundancy in the four main layout file for the site.
They now share a single primary.html include file which carries most of the weight. This
will avoid having to constantly make the same change in four different files.
- Improve the generated HTML for <figure> elements which makes
things better for screen readers.
- Simplify the HTML & CSS for the footer.
The sidenav now hovers over the main text instead of pushing the main
text sideways.
The rendering of the sidenav toggler button now matches the "back to top"
button I added last week.
Martin Taillefer
Jason Young
Frank Budinsky
Tao Li
Steven Dake
Lin Sun
mtail
Dionna Amalie Glaze
Allan Targino
Vadim Eisenberg
Yinjie Chen
Julien Furgerot
lei-tang
Krishna Pagadala
Guang Ya Liu
imgbot[bot]
Julien Senon
Rich Curran
Joy Zhang
Sanket Patel
Ozben Evren
jasmine-jaksic
Oliver Liu