Create User Journeys MVP (#4630)
* Create User Journeys Squashed commits: [9a360e8] add page link functionality (+1 squashed commit) Squashed commits: [1cbefa4] Rework App Dev "I want to..." (+1 squashed commit) Squashed commits: [0013eb1] Create User Journeys * structure 2nd page * prepare docs/home for user journey portal * Create sample.html * Update sample.html * Update index.md * Create index.html * Update index.html * Update index.html * Update index.html * Delete index.html * add custom js mechanism * bug fix * put in docsContent div * add docsportal layout * move title from layout into page * move user-journeys/ into /docs/ * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update index.md * Update style_user_journeys.css * add initial draft for app dev user journey * add links, rough outline * fix a few things before demo/discussion * rework intro section * Update index.md * Update style_user_journeys.css * Update index.md * Update index.md * Update style_user_journeys.css * Update index.md * Update index.md * Update style_user_journeys.css * Update index.md * Update index.md * Update style_user_journeys.css * Update style_user_journeys.css * Update index.md * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update index.md * Update index.md * Update index.md * Update style_user_journeys.css * Update index.md * Update index.md * Update index.md * Update style_user_journeys.css * Update style_user_journeys.css * Update index.md * Update index.md * Update index.md * Update user-journeys.js * Update index.md * Update docsportal.html * Update style_user_journeys.css * Update docsportal.html * add and reorganize content for review * edit mostly minikube install * Updates squashed (+51 squashed commits) Squashed commits: [2e18ea8] Update application_developer-foundational.html [78fd490] autogenerate home index from toc [42e89f6] Update application_developer-foundational.html [a77d7d6] Update application_developer-foundational.html [0a489be] Update application_developer-foundational.html [5b4702f] Update style_user_journeys.css [90035a6] Update application_developer-foundational.html [db4fb19] Update application_developer-foundational.html [4188ebc] Update style_user_journeys.css [aec303b] Update application_developer-foundational.html [679d7f6] Update style_user_journeys.css [e8019bf] Update application_developer-foundational.html [2d91bf6] Update style_user_journeys.css [56a49a9] Update application_developer-foundational.html [79cfb6e] Update application_developer-foundational.html [f3ec0c5] Update application_developer-foundational.html [756a42e] Update style_user_journeys.css [208cde1] Update index.md [66241e4] Update index.md [ea8df7f] Update style_user_journeys.css [0778054] Update style.css [dcd0863] Update user-journeys.js [4a99502] Update user-journeys.js [ddf3820] Update user-journeys.js [9650dfd] Update user-journeys.js [6773597] Update user-journeys.js [0e7849e] Update user-journeys.js [8c99ba7] Update style_user_journeys.css [68d5a8a] Update user-journeys.js [45c85fe] Update user-journeys.js [7bd4a5d] Update index.md [c53c6cd] Update index.md [281e4d3] Update style.css [8e5efae] Update application_developer-foundational.html [787f78e] add newline to custom js list [eea0d10] Update style_user_journeys.css [295b4d3] Update docsportal.html [49f7130] Update index.md [0125bc6] Update style_user_journeys.css [a803584] Update style_user_journeys.css [5b97319] Update index.md [0aa34b2] update kubernetes.github.io links [62c9981] hide "Edit this Page" button for portal [1fd0226] Update style_user_journeys.css [bd35646] Update style_user_journeys.css [d7a8b81] Update style_user_journeys.css [0c1e459] Update user-journeys.js [9eb237d] Update style_user_journeys.css [99685cd] Update index.md [516079a] Update index.md [1386033] Update style_user_journeys.css * add, edit app dev content, links * move user persona data to yaml * add links * edit, reorganize for navigation * Update style_user_journeys.css * Update application_developer-foundational.html * Update application_developer-foundational.html * add configmaps * move links * edits before merge * union with #5913 * revert and overwrite for clean #5913 merge * merge in #5913 changes * fix Travis error * Refactor JS for User Journeys portal (#6473) * comment code * add arbitrary number of info links * copy file to correct directory, clean up HTML * add back in current stylesheet refs * Set default message when no persona selected (#6495) * comment code * add arbitrary number of info links * Set default message when no persona selected * copy file to correct directory, clean up HTML (#6502) * copy file to correct directory, clean up HTML * add back in current stylesheet refs * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update application_developer-foundational.html * Update application_developer-foundational.html * Update application_developer-foundational.html * Update application_developer-foundational.html * Update application_developer-foundational.html * Update style_user_journeys.css * Update style_user_journeys.css * Update application_developer-foundational.html * [User Journeys] Add content template (#6523) * remove deprecated directories * add user journey content template * Convert app dev - foundational to md * support general, non-hard-coded formatting for user journey content pages * Update application_developer-foundational.html * Update application_developer-foundational.html * Update application_developer-foundational.html * Update application_developer-foundational.html * Update application_developer-foundational.html * Chenopis uj sprint 20171222 (#6748) * move section banners out of docsection1 divs * revert * liquid hack * modify js hack * add intermediate and advanced app developer with scroll * clean up app dev foundational content * fix formatting * remove html pages * add new pages to toc * Add Docs Contributor persona links * rebalance docs contributor links * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update foundational.md * Update foundational.md * Update style_user_journeys.css * resetting cluster ops content into updated format (#6783) * resetting cluster ops content into updated format * stage interstitial pages from app_developer user journey * adding cluster ops user journey interstitial pages to ToC _data * cluster op overview and initial segment * move working text into a comment * initial foundational content for cluster ops * restructuring * roughing out intermediate resource content * add notes/detail from user-journey google doc reference details on what to cover in foundation/intermediate/adv sections * imperative language in "I want to..." content * update entry page yaml strings * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Remove personas and buttons not in MVP * Update home.js * normalize strings for 'I want to' entries * Reorder Contributor buttons * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update app-developer.yaml * Sort buttons by index value (#6925) * Sort buttons by index * fix bug * Update app-developer.yaml * Update app-developer.yaml * Update app-developer.yaml * Update intermediate.md * Update advanced.md * Add community-contributor links * change foundational/intermediate/advance topics icons * update app-developer icons * add code-contributor links * remove ecosystem-contributor, renumber contributor indexes * update links, add KEP link * reorder contributor personas * change icon for release process * stub out cluster operator intermediate UJ * Set up URL state for user journey combinations of path, persona, level * add path for about kubernetes, fix formatting and javascript appropriately * add definition for personas and fix ui spacing * interim edits to intermediate cluster op user journey * Update links in Browse Docs portion of home page. * more intermediate cluster ops content * adding in logging and monitoring content, as well as additional resource listings * button - keep words together * Move about blurb to top of docs/home page (#7000) * Move about blurb to top of docs/home page * fix conflict * retire binary_release.md * fix blurb formatting (+1 squashed commit) Squashed commits: [e2e5032] Add links to blurb * fix docsportal (+1 squashed commit) Squashed commits: [f687e71] add noedit flag * Fix home ToC * tweak blurb styling * reorg docs-home links * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Update style_user_journeys.css * Add some links for Cluster Ops - Advanced Topics (#7130) * Add some links for Cluster Ops - Advanced Topics * add back pick right solution * app developer content * minor edits * Choose icons for cluster operator links * swap logos
This commit is contained in:
Andrew Chen
committed by
k8s-ci-robot
k8s-ci-robot
parent
731b87f3e2
commit
1e5bb1f8de
@@ -103,7 +103,7 @@ kubectl apply -f "https://git.io/weave-kube"
|
||||
|
||||
### Example Liquid template code for tabs
|
||||
|
||||
Below is the [Liquid](https://shopify.github.io/liquid/) template code for the tabs demo above to illustrate how to specify the contents of each tab. The [`/_includes/tabs.md`](https://git.k8s.io/kubernetes.github.io/_includes/tabs.md) file included at the end then uses those elements to render the actual tab set.
|
||||
Below is the [Liquid](https://shopify.github.io/liquid/) template code for the tabs demo above to illustrate how to specify the contents of each tab. The [`/_includes/tabs.md`](https://git.k8s.io/website/_includes/tabs.md) file included at the end then uses those elements to render the actual tab set.
|
||||
|
||||
The following sections break down each of the individual features used.
|
||||
|
||||
|
||||
+134
-27
@@ -1,54 +1,161 @@
|
||||
---
|
||||
approvers:
|
||||
- bgrant0607
|
||||
- thockin
|
||||
- chenopis
|
||||
title: Kubernetes Documentation
|
||||
layout: docsportal
|
||||
noedit: true
|
||||
cid: userJourneys
|
||||
css: /css/style_user_journeys.css
|
||||
js: /js/user-journeys/home.js, https://use.fontawesome.com/4bcc658a89.js
|
||||
display_browse_numbers: true
|
||||
---
|
||||
|
||||
Kubernetes documentation can help you set up Kubernetes, learn about the system, or get your applications and workloads running on Kubernetes. To learn the basics of what Kubernetes is and how it works, read "[What is Kubernetes](/docs/concepts/overview/what-is-kubernetes/)".
|
||||
{% unless page.notitle %}
|
||||
<h1>{{ page.title }}</h1>
|
||||
{% endunless %}
|
||||
|
||||
## Interactive Tutorial
|
||||
<div id="user-persona-data" class="hide">
|
||||
{{ site.data.user-personas | json | replace: "=>", ": " }}
|
||||
</div>
|
||||
|
||||
The [Kubernetes Basics interactive tutorial](/docs/tutorials/kubernetes-basics/) lets you try out Kubernetes right out of your web browser, using a virtual terminal. Learn about the Kubernetes system and deploy, expose, scale, and upgrade a containerized application in just a few minutes.
|
||||
<div class="hide">
|
||||
{% assign skip_uj_paths = "migrators" | split: "," %}
|
||||
{% for path in site.data.user-personas %}
|
||||
{% if skip_uj_paths contains path[0] %}
|
||||
{% else %}
|
||||
{% for persona in path[1] %}
|
||||
<div class="persona-def-data" data-name="{{ persona[0] }}">
|
||||
{% assign persona_info = persona[1] %}
|
||||
{% if persona_info.glossary_id %}
|
||||
{{ site.data.glossary[persona_info.glossary_id].short-description }}
|
||||
{% else if persona_info.short_desc %}
|
||||
{{ persona_info.short_desc }}
|
||||
{% endif %}
|
||||
</div>
|
||||
{% endfor %}
|
||||
{% endif %}
|
||||
{% endfor %}
|
||||
</div>
|
||||
|
||||
## Installing/Setting Up Kubernetes
|
||||
<div id='aboutWrapper'>
|
||||
<div class="aboutsection" markdown="1">
|
||||
|
||||
[Picking the Right Solution](/docs/setup/pick-right-solution/) can help you get a Kubernetes cluster up and running, either for local development, or on your cloud provider of choice.
|
||||
Kubernetes is an open source system for managing [containerized applications](https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/)
|
||||
across multiple hosts, providing basic mechanisms for deployment, maintenance, and scaling of applications.
|
||||
The open source project is hosted by the Cloud Native Computing Foundation ([CNCF](https://www.cncf.io/about)).
|
||||
|
||||
## Concepts, Tasks, and Tutorials
|
||||
<div class="aboutcolumn" markdown="1">
|
||||
[Download Current Release](/docs/imported/release/notes/)
|
||||
</div>
|
||||
<div class="aboutcolumn" markdown="1">
|
||||
[Supported Doc Versions](/docs/home/supported-doc-versions/)
|
||||
</div>
|
||||
|
||||
The Kubernetes documentation contains a number of resources to help you understand and work with Kubernetes.
|
||||
</div>
|
||||
</div>
|
||||
|
||||
* [Concepts](/docs/concepts/) provide a deep understanding of how Kubernetes works.
|
||||
* [Tasks](/docs/tasks/) contain step-by-step instructions for common Kubernetes tasks.
|
||||
* [Tutorials](/docs/tutorials/) contain detailed walkthroughs of the Kubernetes workflow.
|
||||
<div class="paths">
|
||||
<div class="navButton users">Users</div>
|
||||
<div class="navButton contributors">Contributors</div>
|
||||
<!-- div class="navButton migrators">Migration Paths</div -->
|
||||
<a> <div class="navButton browse">Browse Docs</div></a>
|
||||
</div>
|
||||
|
||||
## API and Command References
|
||||
<div id="cardWrapper">
|
||||
<div class="display-bar">I AM...</div>
|
||||
<div class='cards' markdown="1">
|
||||
<div class='docsection1' id='persona-definition'>.</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
The [Reference](/docs/reference/) documentation provides complete information on the Kubernetes APIs and the `kubectl` command-line interface.
|
||||
<div style='text-align: center;' class="applicationDeveloperContainer">
|
||||
<div class="display-bar" id="subTitle">LEVEL</div>
|
||||
<div class="levels">
|
||||
<div class="level" data-name="foundational">
|
||||
<i class="fa fa-sign-in" aria-hidden="true" style="font-size:50pt !important;padding-top:7% !important;padding-bottom:15% !important"></i>
|
||||
<br>
|
||||
<div class="tabbottom" style="padding-top:5%;padding-bottom:5%">
|
||||
Foundational
|
||||
</div>
|
||||
</div>
|
||||
<div class="level" data-name="intermediate">
|
||||
<i class="fa fa-university" aria-hidden="true" style="font-size:50pt !important;padding-top:7% !important;padding-bottom:15% !important"></i>
|
||||
<br>
|
||||
|
||||
## Tools
|
||||
<div class="tabbottom" style="padding-top:5%;padding-bottom:5%">
|
||||
Intermediate
|
||||
</div>
|
||||
</div>
|
||||
<div class="level" data-name="advanced">
|
||||
<i class="fa fa-magic" aria-hidden="true" style="font-size:50pt !important;padding-top:7% !important;padding-bottom:15% !important"></i>
|
||||
<br>
|
||||
<div class="tabbottom" style="padding-top:5%;padding-bottom:5%">
|
||||
Advanced Topics
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
The [Tools](/docs/tools/) page contains a list of native and third-party tools for Kubernetes.
|
||||
<div class='infobarWrapper'>
|
||||
<div class="infobar">
|
||||
<span style="padding-bottom: 3% ">I want to...</span>
|
||||
<div id="infobarLinks"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
The [Troubleshooting](/docs/tasks/debug-application-cluster/troubleshooting) page outlines some resources for troubleshooting and finding help.
|
||||
<div id='browsedocsWrapper'>
|
||||
<div class="browseheader" id="browsedocs">
|
||||
<a name="browsedocs">Browse Docs</a>
|
||||
</div>
|
||||
|
||||
## Supported Versions
|
||||
<div class="browsedocs">
|
||||
|
||||
Kubernetes has a _X.Y.Z_ versioning scheme, where _X_ is the major version, _Y_ is the minor version, and _Z_ is the patch version.
|
||||
{% assign sections = "setup,concepts,tasks,tutorials,reference,docs-home" | split: "," %}
|
||||
|
||||
Kubernetes is supported for three minor versions at a time. This includes the current release version and two previous versions.
|
||||
{% for section_id in sections %}
|
||||
|
||||
See the [Kubernetes Release](https://github.com/kubernetes/kubernetes/releases) page on GitHub for the latest release information.
|
||||
{% assign section_data = site.data[section_id] %}
|
||||
{% assign section_toc = section_data.toc %}
|
||||
|
||||
### Minor Versions
|
||||
<div class="browsesection">
|
||||
<div class="docstitle">
|
||||
<a href="{{ section_data.landing_page }}">{{ section_data.bigheader }}</a>
|
||||
</div>
|
||||
|
||||
A certain amount of version skew is permissible between master components, node components, and the kubectl client. Nodes may lag master by up to two versions, but not exceed the master version. Clients may lag master by one version and may exceed master up to one version.
|
||||
{% assign section_toc = section_toc | where_exp: "elt", "elt.title != null" %}
|
||||
{% assign num_pages = section_toc | size %}
|
||||
{% assign column_size = num_pages | divided_by: 3.0 | ceil %}
|
||||
|
||||
For example, a v1.8 master is expected to be compatible with v1.6, v1.7, and v1.8 nodes, and compatible with v1.7, v1.8, and v1.9 clients.
|
||||
<div class="pages">
|
||||
|
||||
### Patch Versions
|
||||
{% for i in (1..num_pages) %}
|
||||
{% assign index = i | minus: 1 %}
|
||||
{% assign offset = index | modulo: column_size | plus: 1 %}
|
||||
{% assign section_elt = section_toc[index] %}
|
||||
|
||||
Patch releases often include critical bug fixes. You should be running the latest patch release of a given minor release.
|
||||
{% if page.display_browse_numbers %}
|
||||
{% assign browse_number = i | prepend: "0" | slice: -2, 2 | append: " - " %}
|
||||
{% else %}
|
||||
{% assign browse_number = "" %}
|
||||
{% endif %}
|
||||
|
||||
{% if offset == 1 %}
|
||||
<div class="browsecolumn">
|
||||
{% endif %}
|
||||
|
||||
{% assign elt_url = section_elt.path | default: section_elt.landing_page | default: "#" %}
|
||||
<a href="{{ elt_url }}">{{ section_elt.title | prepend: browse_number }}</a><br>
|
||||
{% if offset == column_size or i == num_pages %}
|
||||
</div>
|
||||
{% endif %}
|
||||
{% endfor %}
|
||||
|
||||
</div><!-- end pages -->
|
||||
|
||||
</div><!-- end browsesection -->
|
||||
|
||||
{% endfor %}
|
||||
|
||||
</div><!-- end browsedocs -->
|
||||
</div><!-- end browsedocsWrapper -->
|
||||
|
||||
Reference in New Issue
Block a user