* 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.