Commit Graph

113 Commits

Author SHA1 Message Date
Steven Dake 404294c332 Fixes: #2136 (#2399)
* Fixes: #2136

This is a first take at a table-creating tablegen that categorizes
the output of tablegen.py.  Still needed is the actual text that
goes in the description field.

* Address review comments
2018-08-27 12:14:31 -07:00
Pengyuan Bian f4dd3af2f8 Add two new attributes. (#2334) 2018-08-22 04:32:12 -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
mtail 8a51bc2da3 Add a few missing periods. 2018-08-16 12:23:48 -07:00
mtail a1c4aad23f Update reference docs.
This includes a revamp of the grab_reference_docs script to make
it easier to maintain and extend to different sources of docs.
2018-08-16 12:14:27 -07:00
Martin Taillefer be92dc771e
Fix up some aliases. (#2174) 2018-08-07 10:54:49 -07:00
Martin Taillefer 5d6c5c1e5c
Refresh the glossary and attribute vocabulary based on current reality. (#2142) 2018-08-06 13:44:05 -07:00
Jimmy Song 0b2ea1d38e Enable extra lint stuff (#2158) 2018-08-06 09:43:31 -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
Venil Noronha 5342ab2a80 Fix broken Mixer Adapter Dev Guide links (#2144)
Signed-off-by: Venil Noronha <veniln@vmware.com>
2018-08-03 16:32:56 -07:00
Steven Dake b3fa64fa41 Fix generated tablegen.py (needs backport) (#2084)
Original table was dreadfully wrong.
2018-07-31 04:49:16 -07:00
Steven Dake c5fbbff2d1 This isn't quite right but includes all kv pairs (#2079)
As well as their default value.  I will work more on the python
generation tool this evening after dinner and push an update, but
it makes alot of sense to just merge this as is assuming it renders
properly.
2018-07-30 19:01:41 -07:00
mtail 2549b7b0b5 Update reference docs. 2018-07-30 17:23:03 -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
KeZhang 77c2d0e291 istioctl proxy-config bootstrap word wrong (#2015) 2018-07-27 11:00:30 -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
mtail 4bad2ec7f5 Update reference docs. 2018-07-25 11:09:46 -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
Pengyuan Bian 98281c123f Add `add` to expression reference. (#1902) 2018-07-20 16:10:35 -07:00
mtail 3bb4f605f2 Update reference docs. 2018-07-20 13:29:08 -07:00
mtail a580eab41c Update reference docs. 2018-07-20 06:23:03 -07:00
Pengyuan Bian ec6a89bd5c Update default metrics page (#1874) 2018-07-19 06:16:40 -07:00
Pengyuan Bian 82685030a4 Add two expressions. (#1840) 2018-07-18 04:41:19 -07:00
Yossi Mesika 0ea541d13f Move Helm customization section to the references category (#1699) 2018-07-16 21:46:52 -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
Martin Taillefer 597f7ce3b4
Enable more linting rules (#1824)
Fix feported linting errors.
2018-07-15 07:49:11 -07:00
mtail 97a59a82e0 Update reference docs. 2018-07-13 20:06:09 -07:00
Martin Taillefer 72f6f1353f
Update reference docs. (#1812) 2018-07-13 15:00:52 -07:00
Yangmin 4fb7235368 Add authorization directory in Reference. (#1768)
* Add a authorization directory in Reference.

* address comments.

* fix markdown lint error.

* fix lint and exchange the constraints/properties table.
2018-07-12 16:26:35 -07:00
Vadim Eisenberg c465190613 [WIP] add description of connection.requested_server_name (#1712)
add description of connection.requested_server_name
2018-07-10 22:46:42 -04:00
Pengyuan Bian 1776f73065 Update default metrics page (#1740) 2018-07-10 12:56:17 -07:00
mtail 9562fac259 Update reference docs. 2018-07-10 11:14:04 -07:00
Kuat 6e97d79a2d cleanup principals (#1722)
Signed-off-by: Kuat Yessenov <kuat@google.com>
2018-07-09 19:53:14 -07:00
mtail 95ea76c737 Update reference docs. 2018-07-09 14:49:30 -07:00
Kuat 3175bf354a push attribute rename (#1713)
Signed-off-by: Kuat Yessenov <kuat@google.com>
2018-07-09 11:42:00 -07:00
mtail 6a33b0052b Update reference docs. 2018-07-05 06:46:46 -07:00
Martin Taillefer 07ed229051
Simplify linking to GitHub content. (#1669)
- Add <github_file> <github_blob> and <github_tree> to make it simpler to link to the right
place on GitHub.

- Use these new sequences throughout the docs.

- Also, fix bad HTML generated for the TOC in certain cirsumstances.

- Fix extra blank line inserted at the bottom of indented code blocks.
2018-07-04 04:16:49 -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 843bef8ddb Update reference docs. 2018-06-29 17:42:41 -07:00
Kuat 221f373a6c attributes: replace reporter local with reporter type (#1627) 2018-06-29 06:38:14 -07:00
Kuat 5bdf5acdf6 attributes: update desitnation name and namespace definitions (#1613) 2018-06-28 06:00:30 -07:00
mtail 5cd535e05a Final round of file renames. 2018-06-27 07:21:21 -07:00
mtail 16b5cab3d7 Third round of file renames.
Only thing left are the reference files.
2018-06-27 06:32:20 -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
Jason Young e0d5cee035 update galley references docs to istio.io (#1556) 2018-06-20 06:24:57 -07:00
Jason Young 5a25251d28 make reference generation work with golang vendor directory (#1557) 2018-06-19 16:50:54 -07:00
Miguel Angel Medina Mondragon b1a1e239e5 improved HTTPRoute-timeout doc (#1546) 2018-06-18 19:31:55 -07:00
Kuat 8511296564 Document updated attributes (#1539)
* updated attributes

Signed-off-by: Kuat Yessenov <kuat@google.com>

* over zealous linter

Signed-off-by: Kuat Yessenov <kuat@google.com>

* add a note about source name

Signed-off-by: Kuat Yessenov <kuat@google.com>

* typos

Signed-off-by: Kuat Yessenov <kuat@google.com>

* mention that original names will be gone

Signed-off-by: Kuat Yessenov <kuat@google.com>
2018-06-18 12:26:55 -07:00
mtail 80543ef7f4 Update reference docs. 2018-06-13 07:03:54 -07:00
mtail 75b550307c Update reference docs. 2018-06-12 11:34:01 -07:00
gargnupur 8210d2e4fc Add documentation for default metrics exported by Istio (#1485)
* Create metrics.md

* Update .spelling

* Update metrics.md

* Update metrics.md

* Update metrics.md

* Update metrics.md
2018-06-12 09:53:59 -07:00
mtail f51c592a5a Update reference docs. 2018-06-12 07:04:21 -07:00
mtail 5bfc6bafea Update reference docs 2018-06-11 22:29:34 -07:00
Zack Butcher d153cba60a Remove source.principal attribute since it did not make the 0.8 cut; we should add back when the PR adding it to the manifest, https://github.com/istio/istio/pull/5540, is added to a 0.8.x release. (#1487) 2018-06-08 15:53:23 -07:00
mtail abb4b5249f Really fix formatting of expression table. 2018-05-31 12:55:15 -07:00
Yangmin e45ae989f9 Fix the table format in expression-language.md (#1396)
Add `|` to make the table correct and use `\` to escape the `|` character inside the table. Not sure if this is the right way to fix but the preview page looks good.
2018-05-31 12:33:01 -07:00
mtail bf5ac2104c Fix aliases. 2018-05-31 03:59:00 -07:00
mtail 3d5376d80b Delete an alias for an experiment. 2018-05-31 03:44:44 -07:00
Martin Taillefer 80d948d44c
Update reference docs. (#1385) 2018-05-30 10:32:00 -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