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.
- Get rid of all the chrome when printing a page. So no headers, sidebars, etc.
- Ensure that PRE blocks are fully expanded when printing instead of
showing a scroll bar.
- Generate endnotes for each page printed which lists the URLs of the various links
on the page. Each link site is annotated with a superscript number referencing this
table.
* Add multicluster deployment documentation to Istio
* Change *Ip to *Endpoint a per request
* Fix a typo
* Address all reviewer comments
Note, SVG diagram will be handled as a follow-on PR.
* Fix legitimate spelling errors found by gate
* Some backticks to fix spelling errors and other misc cleanups
* some spelling and backticks.
* Expand spelling exemptions dictionary slightly
* Correctly spell routable.
* Address reviewer comments.
Needed a rebase in the process.
* A minor consistency change
* Address reviewer comments.
* Add a caveats and known issue tracker to the documentation
Early on during review of this PR, I believe there was a review
asking for caveats, but it has disappeared from the github comments.