Commit Graph

159 Commits

Author SHA1 Message Date
Martin Taillefer d6b3bfac56
Add support for {{< quote >}} (#3237) 2019-02-12 08:22:28 -08:00
Martin Taillefer b3db41da99
Added more lint rules and fix offenders (#3227)
- Ensure that references to GitHub content use the proper annotations so
we get links to the correct branches.

- Added a check to make sure content is not using blockquotes (instead of
{{< warning >}}, {{< tip >}}, and {{< idea >}}. This check is currently
disabled, pending the Chinese content being updated.

- Fix a few violations of these new checks.
2019-02-11 12:49:47 -08:00
Martin Taillefer 141a2182c2
A bunch of infrastructure cleanup. (#3221)
- Switch from the Bootstrap grid system to the CSS grid. Much cleaner and faster.

- Add "See also" and "Links" to the list of translation strings

- Prevent the breadcrumb line from being included in the link endnotes when printing a page.

- Cleanup/rename several of the CSS and layout files for clarity.

- Switch the community page from using clumsy tables to a much cleaner approach
with shortcodes.

- Don't show buttons in the link endnotes when printing a page.

- Don't render the link endnotes section at all if the page has no links to include
2019-02-10 07:21:19 -08:00
Martin Taillefer c32db038ed
Introduce support for glossary term highlighting. (#3211)
- You can now mark a word as being a glossary term. This will trigger special rendering inviting the
user to click on the item in order to get a popup window showing the glossary text for the term. This
is very nice when introducing a new term within a page.

- Updated our dependency  on Bootstrap and ClipboardJS to the latest versions.
2019-02-08 07:29:38 -08:00
Martin Taillefer 2eebc0a3d5 Expand the security vulnerability page. (#3195) 2019-02-05 09:40:23 -08:00
Martin Taillefer dd782b3d12
Improve the looks of warnings, info blobs, and tips. (#3181) 2019-01-31 12:11:53 -08:00
Rigs Caballero e958cf600f Update the Creating and Editing pages guide. (#3166)
* Update the Creating and Editing pages guide.

The Istio Steering Committee approved new guidelines for blog posts. This PR
implements the approved changes on the appropriate page.
2019-01-29 13:41:00 -08:00
Martin Taillefer 0a3cf89ecc
Update the authoring guide. (#3148) 2019-01-29 07:01:00 -08:00
Martin Taillefer 1c1242ffc4
Fix spelling and grammar stuff throughtout the site. (#3114) 2019-01-21 09:35:38 -08:00
Tim Swanson 0e66794cf7 Add new setup instructions about istio-cni (#2902)
* Add new setup instructions about istio-cni

* Fix review nits.

* Add Istio CNI to about/features as an alpha status feature

* Reword intro and installation steps

* Add sidecar injection compatibility info

* fix review comments

* Fix wording nits from sdake

* Fix nits and formatting comments from geeknoid.

* Added general CNI spec link and Istio k8s requirements link.
2019-01-19 04:54:55 -08:00
Rigs Caballero 69be16b2f1 Add the formal process to become a member of an Istio repo. (#3099)
* Add the formal process to become a member of an Istio repo.

This process is detailed as agreed upon by the Istio Technical Oversight Committee.

Signed-off-by: rcaballeromx <grca@google.com>

* Point to existing content related to community roles.

Signed-off-by: rcaballeromx <grca@google.com>
2019-01-17 14:42:50 -08:00
Rigs Caballero 16040ecca2 Add a review process to our contribution guide. (#2980)
* Add a review process to our contribution guide.

To avoid PR from being merged before the content has been reviewed, contributors
must add a comment with the appropriate command beforehand. I've added this
process. Additionally, I cleaned up the process on how to contribute new
documents.

Signed-off-by: rcaballeromx <grca@google.com>

* Changed button above the list to fix linter issues.

Signed-off-by: rcaballeromx <grca@google.com>

* Change the removal of `/hold` to after review publication.

Now the process asks reviewers to comment with `/hold cancel` after publishing
the review but before the comments are addressed by the contributor.

Signed-off-by: rcaballeromx <grca@google.com>

* Fix small consistency issue.

Signed-off-by: rcaballeromx <grca@google.com>
2019-01-16 12:20:48 -08:00
Martin Taillefer 4c17edcd56
Fix a few issues. (#3092)
- Fix formatting for the Subscribe link on blog pages. That got broken in some refactoring I did a while back.

- Remove a few *NOTE* and _NOTE_ instances and replace with the canonical icons

- Add a link to our community repo in the Getting Involved page.
2019-01-15 20:50:00 -08:00
Martin Taillefer d7c4eb33f5
Switch to discuss.istio.io (#3071) 2019-01-10 07:11:00 -08:00
Martin Taillefer 51f878a914
Simplify use of the image shortcode. (#3021)
- The width value now defaults to 100%, so it doesn't need to be specified explicitly
in many cases.

- The ratio value can now be computed automatically for PNG and JPG files, so it doesn't need
to be specified explicitly.
2019-01-03 07:46:55 -08:00
Martin Taillefer 1ca2020e42
Improve boilerplates so they can now contain shortcodes (#3019) 2019-01-02 17:42:56 -08:00
Martin Taillefer b22c30f127
Add support for boilerplate text. (#3005) 2018-12-23 07:46:24 -08:00
Martin Taillefer 2c692e2a0b
Release notes for 1.0.5 (#3003) 2018-12-22 10:04:25 -08:00
Martin Taillefer 8fd070d4ca Fix CI failures. (#2989)
This includes updating to the latest reference docs from the 1.1 branches.
2018-12-17 15:05:38 -08:00
Gary Brown 68579c929c Add initial doc changes related to tracing provider and support for z… (#2884)
* Add initial doc changes related to tracing provider and support for zipkin backend

* Suggestion for way to incorporate more tracing backends - using text from lightstep PR #2844

* Update based on review comments. Moved lightstep content (from #2844 to subfolder

* Add more zipkin content and images

* Remove jaeger from dt page

* Updates following comments

* Updates to address comments
2018-12-15 13:06:38 -08:00
Martin Taillefer f17a5d2e79
Fix a bunch of absolute links that should have been relative. (#2933)
- Added a linter rule to prevent further occurances.
2018-11-30 06:41:56 -08:00
mandarjog 1ccfbcf88a release notes 1.0.4 (#2910) 2018-11-28 15:38:12 -08:00
Jason Young 6b9ebaf29a Add initial istioctl and galley release notes (#2889)
* Add initial istioctl and galley release notes

* Update index.md

* Update index.md

* Apply suggestions from code review

Thanks @rcaballeromx!

Co-Authored-By: ayj <jasonyoung@google.com>

* fix linter
2018-11-19 15:37:01 -08:00
Zack Butcher 42728c0020 clarify the patch notes to make it obvious that wildcards are still allowed in service entries (#2888) 2018-11-16 12:33:17 -08:00
Chunlin Yang bf264f1ae6 Delete Service Graph (#2874)
Signed-off-by: Chun Lin Yang <clyang@cn.ibm.com>
2018-11-14 06:59:03 -08:00
Rigs Caballero c64d38fdda Improve style guide to clarify common issues. (#2857)
* Improve style guide to clarify common issues.

These changes are meant to clarify some common questions I've encountered during
content review. I've also removed the exception for passive voice since there is
no need to obscure the subject of a sentence in documentation. I've also
introduced the concepts of title case and sentence case to align with other
style guides for clarity.
2018-11-09 12:52:50 -08:00
mtail a251c3d52c Fix some broken Envoy links. 2018-11-06 05:24:49 -08:00
mtail 1b9e81f771 Site improvements
- The release note index page is now rendered as a simple list rather than the normal gallery mode.

- Fix use of toc: front-matter, which should be skip_toc instead.
2018-10-31 07:15:57 -07:00
mtail 530e0d6ebe Fix a few issues with the release notes. 2018-10-31 06:56:13 -07:00
mandarjog 9c57b614b0 Add 1.0.3 release notes (#2807) 2018-10-30 10:15:38 -07:00
Yangmin Zhu 054a7c0ad9 rbac: deprecate RbacConfig with ClusterRbacConfig (#2761) 2018-10-26 11:11:32 -07:00
Martin Taillefer 9cbb0db783
Clearly indicate which version of k8s we support. (#2786) 2018-10-19 12:53:12 -07:00
Vincent 521420bf1c There is no chapter for Cloud-Foundry (#2769) 2018-10-15 07:19:00 -07:00
mtail ffd319e5e2 Update sec vulnerability reporting address. 2018-10-12 19:31:45 -07:00
John Mazzitelli 15d6dee1f3 Add Kiali Task to istio.io (#2715)
* add Kiali Task to istio.io
add deprecation notice to the SerivceGraph Task

* add some more instructions on getting the Kiali UI to help assist those on environments like minikube

* add cleanup instructions for kiali

* simplify the section to determine kiali url

* use present tense

* more present tense changes
split up the "Send traffic" item into two actions.

* more verb tense changes to get things more into present tense

* updates based on some feedback

* re-write the "determine kiali url" section

* split login step into two steps - visit with browser, then login

* reword some of the steps involving logging in and looking at the initial pages.

* reword the graph type step - use list items, not numbered, for the different types. Adds the new service graph type.

* reword the examine istio config step

* changes to the api section

* some final changes of the api section and the cleanup section

* trivial fix to capitalization

* some small trivial changes
2018-10-12 13:54:07 -04:00
Shriram Rajagopalan 63c4d2bc83 Fix feature status of multicluster mesh (#2755)
It says its in Beta, which I think was accidental.
Given that this area is evolving a lot, demoting it to alpha as it doesn't satisfy the beta conditions (of production usage) as there is no DNS solution/doc, no Istio policy starting with DNS, lack of mixer policies, and scale issues in Pilot.
2018-10-10 09:12:01 -07:00
Martin Taillefer a2026aab5e
Clean up a bunch of loose ends (#2745) 2018-10-05 22:21:56 -07:00
Martin Taillefer 9540cd2d19
Site improvements. (#2742)
- Auto-generate tables of template->adapters and adapter->templates

- Make the "Edit this page on GitHub" menu option track the branch correctly instead of always pointing to master.

- Update the reference docs.
2018-10-05 11:15:26 -07:00
Martin Taillefer 7d150577ed
Add support for the last_update front-matter field. (#2690) 2018-09-25 15:24:14 -07:00
Martin Taillefer 3acfe3fe40
Replace references from istio.github.io to istio.io (#2686) 2018-09-25 12:13:38 -07:00
Martin Taillefer edfdf7d795
Site improvements. (#2663)
* Site improvements.

- For SVG images, authors no longer need to specify image ratios
(which is a constant source of errors)

- Move more icons into the new icons.svg file to further reduce
average page load times.

- Rationalize Istio logo file names.

- Improve underlining behavior for sidebar headers and the RSS feed
Subscribe link.

- Made the RSS feed subscribe link open in a new tab.

- Increase the constract ratio for some elements in dark mode
text blocks (namely, YAML field names)

- Reduce the "brightness" of the light bulb icon which helps it
not pop so much in dark mode.

- Optimize the fonts we load and the order we load them in so as to improve page load time and
reduce the initial render time.

* Sadly, embedding SVGs into the HTML results in duplicate element ids, which is invalid HTML :-(
2018-09-21 17:56:46 -07:00
Martin Taillefer 0a4264417f
Site improvements (#2633)
- Use a new approach to managing icons. This has two primary benefits:

  - It makes it possible to color the icons such that they look good in the
    dark theme. Previously, the icons were rendered in black on dark grey when
    using the dark theme.

  - The average payload size for our web pages is reduced and we better use the
    browser cache.

- The new icon approach makes it possible to remove our dependency on the fontawesome
  package, which further slims down our payload requirement

- Refresh our iconography for a slightly lighter look.

- Remove the extra thick left-hand border of text blocks to lighten the
look.

- Added a "NN minutes to read" indication on top of each page. This is
only displayed if the count is > 1 minute.

- Added a calendar icon next to the blog post date.

- Exposed a bunch of strings that were buried in CSS/JS to translation.

- Add the 'keywords:' front-matter fields to the Hugo archetypes.
2018-09-17 08:52:23 -07:00
Guang Ya Liu ba2d225182 Updated IBM alt. (#2614) 2018-09-14 13:42:23 -07:00
lichuqiang 0d6c346af9 add Huawei to the partner list (#2613) 2018-09-14 08:04:23 -07:00
Martin Taillefer 9f187ee64f Improve the release note link shortcode. (#2597)
- When displaying a "Changes" button, we now display a diff from the previous patch to the current
patch, instead of a diff from the base release to the current patch.

- Properly localize the release note buttons so these can be translated.
2018-09-12 10:47:45 -07:00
oreasono fcafc4b623 Add "COOHOM" logo into customers (#2536) 2018-09-06 12:53:58 -07:00
Brian Marshall 370c53fc5d Add Aspen Mesh to partner page (#2515) 2018-09-04 21:11:54 -07:00
Martin Taillefer 837f16af99
Fix a few lint errors and dissable the release notes links until ready. (#2522) 2018-09-04 20:50:33 -07:00
mtail 1985d663d3 Add 1.0.2 release notes and blog 2018-09-04 20:15:14 -07:00
mtail 25988bbdd2 Fix page icons for the community pages. 2018-09-02 08:29:43 -07:00