Commit Graph

120 Commits

Author SHA1 Message Date
Bryant Luk b3e0ebb409 Change `mTLS` in YAML config to `mtls` (#2378)
- The `mtls` key is case sensitive.
2018-08-27 14:41:57 -07:00
cmluciano 120e1567f3 Replace a few instances of route rule with VirtualService (#2344)
Signed-off-by: Christopher M. Luciano <cmluciano@us.ibm.com>
2018-08-23 08:26:28 -07:00
Martin Taillefer 5e29d61ff2
Bunch of site fixes & improvements. (#2306)
- Correct the use of OpenGraph annotations. I used the wrong attribute name, so the
annotations were never recognized.

- Added support for Twitter cards to our site, improving the experience of referencing
the site from Twitter posts.

- Added support for the twitter: front matter field for use in blog posts. Specifying this
front-matter entry will show the author's twitter address on the blog post, and will
add a Twitter card entry to the page noting the author's address.

- Renamed the page_icon front matter field to just icon to be consistent with other
entries.

- Made it so the subtitle front matter field can be used anywhere, not just on blog posts.

- Added a lint check to ensure subtitles don't end with a period.

- We now insert an "author" metadata entry whenever the attribution: front matter
field is used.
2018-08-19 11:51:03 -07:00
Martin Taillefer be7c374f29
Switch to Hugo 0.47 (#2288)
- Fixes the bug where not all of our files would get the right lastmod
time extracted from GitHub.

- Fixes most of the cases of bad HTML output around the use of {{<text>}}. There's
still a single bad case which I'll report to the Hugo folks.

- Use Hugo's new --minify option to minify HTML instead of having to use the
separate and slow html-minifier program.

- Fix some bad HTML on the landing page.
2018-08-17 22:33:16 -07:00
Yangmin 053efb78f9 fix sample RbacConfig in concept page. (#2253) 2018-08-16 09:45:43 -07:00
Tao Li b7976e6d94 Remove recovation from security concept doc (#2257) 2018-08-15 09:47:32 -07:00
mtail 6a152a766d Fix incorrect aspect ratio. 2018-08-12 18:14:07 -07:00
Zack Butcher 25f7c61a4b remove the word 'global' as it adds confusion (#2209) 2018-08-10 14:48:48 -07:00
Pahlevi Fikri Auliya 6c4b75084b Remove misplaced "the" (#2198) 2018-08-10 07:25:17 -07:00
Martin Taillefer be92dc771e
Fix up some aliases. (#2174) 2018-08-07 10:54:49 -07:00
Martin Taillefer fd290dc73e
Improve linting (#2148)
- We now detect text blocks that are incorrectly indented.

- We now detect image captions that end in a period.

- We now detect page descriptions that don't end in a period.

- CircleCi now runs linting without minifying HTML first, improving perf and
improving error output.

- In CircleCi, we now have a per-build cache for HTML proofer output. This
helps reduce the frequency of link timeout errors.

- Fix errors flagged by the above new lint checks.
2018-08-04 08:44:06 -07:00
Oliver Liu f83bb8ada0 Fix security concept figure captions etc. (#2087) 2018-08-02 16:07:03 -07:00
mtail e33cb732dc Fix a typo. 2018-08-01 13:11:37 -07:00
Jason Young 2db7f5648d add initial galley intro to "what is istio" concept page (#2113) 2018-08-01 12:10:58 -07:00
Martin Taillefer 26bd62e408
Final release material (#2028)
- New landing page layout and content.

- 1.0 announcement blog post

- New "what is istio" page
2018-07-30 21:37:03 -07:00
Oliver Liu 682db1e3e3 Update Security Concepts (#1912) 2018-07-30 20:46:36 -07:00
Yangmin 9fba9d24ad authz: small fixes and clarification of user and source.principal. (#2067) 2018-07-30 12:29:41 -07:00
Martin Taillefer 1c300c99bd
Spelling improvements (#2037)
Remove a bunch of entries that shouldn't have been in the spelling dictionary
and correct content aoocrdingly.

I'm disabling the Chinese spell checking for now, since I'm not able to fix the
spelling errors that emerged there. Once this PR is in, I'll file an issue to get
those spelling errors addressed and checking reenabled.
2018-07-29 14:27:06 -07:00
Limin Wang 1678690069 Authz doc changes. (#2027) 2018-07-27 21:32:06 -07:00
Vincent 87bc23286f fix yaml syntax error in concepts/securyt (#2018) 2018-07-27 11:00:40 -07:00
Jason Young c27351268b use kubectl for managing Istio API resources (#2002)
* use kubectl consistently throughout for Istio API resource C.R.U.D operations

xref: https://github.com/istio/istio.github.io/issues/1843

* fix typo

* review comments

* remove unnecessary instructions to use `replace` instead of `create`

* fix linter in `zh` content
2018-07-27 10:57:41 -07:00
mtail fc6f620b5e Fix several aspect ratio values. 2018-07-27 06:53:14 -07:00
Dan Ciruli 95fb8df5cf New request flow diagram (#1930)
* New request flow diagram

* Added ingress and egress gateways to diagram

* resized image, updated ratios in .md
2018-07-27 05:55:39 -07:00
mtail c42d9e7ca2 Fix some aspect ratios. 2018-07-26 06:33:53 -07:00
Dan Ciruli 056a13cf1b New adapters diagram (#1928) 2018-07-26 06:25:23 -07:00
Dan Ciruli 7bb01fa9c8 New topology diagrams (#1927) 2018-07-26 06:22:21 -07:00
Martin Taillefer 9d56f3dbe7
Various design changes. (#1976)
- Increase the size of the Copy button in preformatted blocks to make it stand out since it is the
most common used button.

- Shift the copy/download/print buttons in PRE blocks towards the left so they don't overlap the
scroll bar in large text blocks.

- Switch to new fonts.

- Instead of underlining <H2> headers, we now draw a blue bar above them.

- Add an "up level" button at the top of pages.

- Streamline the appearance of the next/previous page links at the bottom of most pages.

- Remove the right pointing arrows from index pages and see also sections. They were just
confusing.

- Add icons to the main pages.

- Slightly change the layout of the glossary page, more to come here.
2018-07-26 06:14:32 -07:00
Dan Ciruli b32b22e9c1 New version of new authz diagram (#1931) 2018-07-25 21:58:40 -07:00
mtail 7797fd427d A few editorial fixes. 2018-07-25 09:57:55 -07:00
Yangmin 973d25c451 Add a slash to the gRPC path format in ServiceRole. (#1950) 2018-07-24 16:16:11 -07:00
mtail 613ffd6cc3 A few editorial fixes. 2018-07-24 13:13:15 -07:00
Rigs Caballero cddace0f45 Remove ghost elements from security diagrams. (#1943)
By removing ghost elements from the SVG files, I could fix the scaling of the
diagrams.

Signed-off-by: rcaballeromx <grca@google.com>
2018-07-24 13:02:37 -07:00
Rigs Caballero c3ab22f604 Edit Security section for clarity. (#1921)
* Edit Security section for clarity.

The edit includes:

* Rewrite of every passive voice instance.
* Consistent use markup to reference code from the examples in the text.
* Added emphasis to make key concepts clearer.
* Added links to the Identity section of the docs.
2018-07-24 10:50:50 -07:00
Dan Ciruli bfc17bb1fe New citadel (auth) diagram (#1929) 2018-07-24 07:50:40 -07:00
Kent Rancourt 217c78af01 bookinfo doc fixes (#1817) 2018-07-23 20:36:23 -07:00
Dan Ciruli b1df371b92 New Authentication diagram (#1925) 2018-07-23 17:24:22 -07:00
Martin Taillefer 5527dcbaf6
Switch uses of funny quotation marks to plain ones. (#1914)
- Use only standard quotation marks to avoid cut & paste stuff not working

- Put in a lint rule to prevent further use of non-plain quotation marks.
2018-07-22 08:48:03 -07:00
Stefan Büringer eb4c7be94b Minor doc fixes (#1910)
Fixed indentation and typos
2018-07-22 07:52:43 -07:00
Frank Budinsky 094007ddff Traffic managment rule config concepts improvements (#1897) 2018-07-20 13:15:36 -07:00
Limin Wang 8973981880 Update authentication concept doc (#1886)
* Update authentication concept doc.

* Fix lint errors.

* Address comments and fixed some links.

* Remove feature stages change from this PR.

I will make a separate PR for it.
2018-07-19 19:10:37 -07:00
Yangmin 0b9e3aba5a update rbac api version to align with istio/istio#6874. (#1879) 2018-07-18 15:21:37 -07:00
Dan Ciruli ba95d12f68 Updating 3 diagrams (#1751) 2018-07-16 21:45:16 -07:00
Limin Wang fd259b3526 Update Istio Authorization Concept. (#1807)
* Update Istio Authorization Concept.

* Fix lint errors and address comments.

* Addressed comments.

* Changed title from "Istio Authorization" to "Authorization".

* Fixed links.

* Addressed comments.

* Addressed comments.

* Fix lint errors.

* Undo unintended changes in .spelling.
2018-07-16 16:46:18 -04:00
jnativio 6d9cfa111c Update Realistic Benchmark section on docs (#1823) 2018-07-15 07:50:50 -07:00
Martin Taillefer 597f7ce3b4
Enable more linting rules (#1824)
Fix feported linting errors.
2018-07-15 07:49:11 -07:00
Frank Budinsky d3450ae829 remove v1alph1 routing references (#1810)
* remove v1alph1 routing references

* Update index.md
2018-07-13 14:39:35 -07:00
Stephen Gilson 4609f8559c Rewrite Rule configuration intro and some minor copy edits. (#1799)
Signed-off-by: Stephen Gilson <gilsonsm@google.com>
2018-07-13 13:55:36 -07:00
mtail da90e9c7bb Minor edits in the P&T concept page. 2018-07-12 13:41:38 -07:00
Stephen Gilson 478c599e64 Copy edits for Traffic Management. (#1772)
Signed-off-by: Stephen Gilson <gilsonsm@google.com>
2018-07-12 07:41:27 -07:00
Will Witman a52a6745a2 Minor edit in last paragraph of What is Istio. (#1741) 2018-07-11 06:54:19 -07:00
Rigs Caballero dbd5268385 Edit the What is Istio file for clarity. (#1737)
* Edit the What is Istio file for clarity.

This edit includes:

* The rewrite of all instances of passive voice
* The simplification of complex sentence structures
* The splitting of run-on-sentences
* The disambiguation of relative pronouns
* The removal of conjunctives such as should, could, and would
* The replacement of long series with lists
* The improvement of punctuation
* The addition of emphatic markup including links

The purpose behind the edits is to improve content flow and allow easier
consumption for international audiences. The simpler structures will also have a
positive impact in the translation.
2018-07-10 12:20:38 -07:00
Dan Ciruli e5b0cfe370 Updated architecture diagram on What Is Istio page (#1738) 2018-07-10 11:02:51 -07:00
Martin Taillefer 181605b27e
Consolidate the security concept pages into a single page. (#1721)
* Consolidate the security concept pages into a single page.

- This updates the security concept material to be on a single page, which matches the
change done last week for the rest of the concept material. This ends up being a less clicky
more directed introduction for newcomers to the platform.

- While I was there, I moved the redundant What is Istio page from our about section and stuck
the content at the top of the What is Istio page in the Concepts section.
2018-07-10 10:26:19 -07:00
Frank Budinsky 880ffebba2 routing concept doc improvements (#1716) 2018-07-10 10:10:32 -07:00
Martin Taillefer a9c4b7a3af
Consolidate perf & scalability pages into a single page. (#1731)
As part of the effort to streamline our content, this consolidates the many small
perf-and-scalability pages into a single concept page. This change is similar to what
we've done to the other concept pages.
2018-07-10 09:42:23 -07:00
Martin Taillefer 1d355094cf Simplify the Concepts section. (#1649) 2018-07-02 06:32:04 -07:00
mtail 0f8724351f Content fixes.
- Remove What's next sections since we now have auto-generated See also sections

- Fix a few incorrectly capitalized headers, "istio", "kubernetes", "sidecar"
2018-06-30 21:42:52 -07:00
Martin Taillefer 0541000be8
Switch from ``` to {{< text >}} to indicate text blocks. (#1644)
This fixes a number of cases of incorrect formatting of code blocks
throughout the site.
2018-06-30 07:11:21 -07:00
mtail e3c1f36859 Guides -> Examples
As agreed, in prep for the 1.0 launch.
2018-06-27 16:03:53 -07:00
mtail 5296742475 First pass at refactoring file locations.
This also reenables html proofing, which I accidentally left
off in an earlier commit.
2018-06-26 23:29:47 -07:00
Thijs Feryn d878a69be4 Potential typo in rules-configuration.yml (#1514)
The "Gateways" section starts with: "A Gateway configure ...". 
Shouldn't that be: "A Gateway configures ..."?
2018-06-14 12:37:25 -07:00
Martin Taillefer 9f3e980147
Add support for an auto-generated See Also section on every page. (#1364)
- We now automatically generate a See Also section on pages when possible.
The links are determined by a reverse index based on the keywords
assigned to each page in its front-matter.

- Do a pass to assign keywords to all our pages to populate the See Also
links.

- Leverage the keywords in the front-matter to generate a keyword metadata entry for each
generated page.
2018-06-11 15:07:32 -07:00
Martin Taillefer 1dcd301bd6
Introduce better linking support to github.com/istio/istio (#1443)
- Within a code block, you can now surround a relative file path with @@. This will
cause the path to be rendered as a link to raw.githubusercontent.com/istio/istio/<path>.
This lets the user click on the link to see the content of the file, which is mighty
handy.

- Updated all code blocks to take advantage of the above.

- Introduce support for {{< branch_name >}} which returns the source code branch
name associated with the current doc site.

- Use {{< branch_name >}} in all our references to content in istio/istio on GitHub. This thus
pins our references to the correct version of the content in GitHub. This prevents errors from
gradually appearing in our doc set as content in GitHub starts to diverge from the expectation
in the site content.
2018-06-06 08:21:18 -07:00
Morven Cao b22194e0e9 fix doc issues for rule configuration. (#1407) 2018-06-01 06:19:19 -07:00
Morven Cao cdb478b103 fix diagram missing issue. (#1406) 2018-06-01 06:12:22 -07:00
mtail dcf7362976 Couple content fixes.
(cherry picked from commit b2daa8e)
2018-05-31 06:50:05 -07:00
Diem Vu 5ba5b642f9 Update authn concepts and tutorials to reflect changes in 0.8 (#1332) 2018-05-29 16:25:11 -07:00
Martin Taillefer d0f8fddfbf
Cleanup (#1363)
- Remove some leftover toc:false front matter from a few pages. The site now generally
figures out automatically that a TOC is not necessary.

- Enable a Hugo feature that queries Git for a last modified date on files. As a result,
instead of having the site build date in the footer, we now have a "this page was last modified"
date.

- Move the landing page's content out of the layouts directory and into the content directory
where it belongs.

- Use Hugo shortcodes for our embedded icon imagery. And make those icons scale with the
font size rather than being fixed sizes.

- Enable support for emojis in our content. Just use 
and you'll get a sailboat for example.
2018-05-26 08:28:14 -07:00
mtail 951a8ed9f4 Switch from Jekyll to Hugo. 2018-05-25 20:02:32 -07:00
mtail 401989fba6 Shuffle content around for the Hugo migration. 2018-05-25 19:27:39 -07:00