Commit Graph

17 Commits

Author SHA1 Message Date
Martin Taillefer 2c62859726 Tweak the installation pages. (#3610)
- Move requirements up to be the first thing people see. This matches
the order presented in the landing page.

- Shuffle the order in the sidebar a bit to correspond to the order
the material is presented in the landing page.

- Clean up some of the wording on the k8s landing page.

- Shorten the platform names used in the sidebar nav so they fit better.
This matches the names used in the Platform Setup section.
2019-03-11 08:56:35 -07:00
Rigs Caballero ee1b180bf7 Implement consistent term for installation related flows (#3577)
* Implement consitent term for installation related flows

Replaced "paths", "instructions", and other similar terms
with the term "flow" to ensure readers from different
Geos are not confused by multiple meanings or idiomatic use.

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

* Implement consistent term for installation related flows

Replaced "paths", "instructions", and other similar terms
with the term "flow" to ensure readers from different
Geos are not confused by multiple meanings or idiomatic use.

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

* Fix typos and lint issue.

Signed-off-by: Rigs Caballero <grca@google.com>
2019-03-08 11:02:33 -08:00
Frank Budinsky eab78670ea Merge minimal with helm install and simpify install paths (#3538)
* Merge minimal with helm install and simpify install paths

* circleci errors

* broken links

* fix broken link
2019-03-07 09:13:37 -08:00
Lin Sun d69c54ca6d
add a dot 2019-03-05 15:40:40 -05:00
Martin Taillefer ad565871d6
Clean up keywords. (#3442) 2019-02-28 17:26:46 -08:00
Rigs Caballero 21c918fbe4 Organize the Kubernetes Installation content. (#3422)
* WIP Add Kubernetes Installation landing page.

This adds the landing page and organizes the content to make it easier to navigate.

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

* Apply initial feedback on landing page content.

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

* Rename and move files to enhance navigation.

Added aliases to redirect after filename changes.

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

* Harmonize all installation guide titles and intros.

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

* Fix all links affected by the restructure.

Fixed all internal links and added aliases to ensure external redirects.

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

* Fix paths of images on the ZH content.

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

* Fix additional links and apply feedback.

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

* Fix link error introduced by rebase.

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

* Remove redundant instances of "Istio" in titles.

Signed-off-by: rcaballeromx <grca@google.com>
2019-02-28 14:37:30 -08:00
Martin Taillefer dd782b3d12
Improve the looks of warnings, info blobs, and tips. (#3181) 2019-01-31 12:11:53 -08:00
Martin Taillefer 9cbb0db783
Clearly indicate which version of k8s we support. (#2786) 2018-10-19 12:53:12 -07:00
Martin Taillefer a2026aab5e
Clean up a bunch of loose ends (#2745) 2018-10-05 22:21:56 -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
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 1d95ab7481 More icons 2018-07-27 15:48:07 -07:00
Rigs Caballero 142303eb2d Edit Kubernetes Quick Start for clarity. (#1762)
* Edit Kubernetes Quick Start for clarity.

This edit includes among other changes:

* Consistent use of markup, line length, and command formatting.
* Grammar, spelling, and other language fixes.
* Use of ordered lists for steps.
* New clear headings for installation options.

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

* Fix linter issues on Kubernetes QS edit.

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

* Fix indentation to fix ordered lists.

Trying to figure out the space in links issue. So far it looks like a false
positive.

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

* Fix links and code blocs for lint.

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

* Remove in-line markup from links.

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

* Fix code-block indentation and spelling lint.

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

* Rewrote link text to avoid spelling lint.

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

* Update index.md
2018-07-12 17:06:35 -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 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