User documentation for Knative components.
Go to file
Swapnil Bawaskar cc325fa475
adding katacoda tutorials (#3142)
* adding katacoda scenarios

katacoda scenarios let people try out Knative without installing
anything on their local machines. The goal is add a number of basic as
well as advanced scenarios that would serve as a guided tutorial for
knative. We start off by adding a serving-intro tutorial

* move up the scenario

* fixing the repo structure to enable multiple scenarios

* upgrading to knative 0.19.0

* adding yaml getting started tutorial

* don't install kn cli for yaml tutorial

* fix revision name

* fix curl command for yaml demo

* check status of the service

* update the title

* adding eventing intro scenario

* fix indent for katacoda markdown

* fix more markdown

* polish

* fix api version

* fix typos

* add a step for sequence

* add broker tutorial

* polish

* adding pathway file

* add order to tutorials

* incorporate feedback

* more feedback

* Apply suggestions from code review

Co-authored-by: Mike Petersen <mike.petersen@ibm.com>

* remove hardcoded version

* adding missing newlines

* fixing trailing whitespace

* more trailing whitespace

* Apply suggestions from code review

Co-authored-by: Mike Petersen <mike.petersen@ibm.com>

* reformat sentence

* review feedback

Co-authored-by: Carlos Santana <csantana23@gmail.com>

* review feedback

dark revision, full migration to green

* quote around T2 does not work

* update apiversion

* cosmetic fixes

* bump timeout to 90 seconds

* blue to green for yaml

Co-authored-by: Mike Petersen <mike.petersen@ibm.com>
Co-authored-by: Carlos Santana <csantana23@gmail.com>
2021-03-30 10:30:21 -07:00
.github Update common github actions (#3330) 2021-03-17 14:57:53 -07:00
blog Drop unnecessary occurrences of master (#3333) 2021-03-11 05:08:26 -08:00
community Update Dart example for latest stable SDK (#3340) 2021-03-15 15:02:41 -07:00
docs Copied the README into _index.md instead of referencing README from (#3382) 2021-03-27 10:04:21 -07:00
hack Drop unnecessary occurrences of master (#3333) 2021-03-11 05:08:26 -08:00
test Reworked shell hello world example (#2832) 2020-11-06 07:53:07 -08:00
third_party/VENDOR-LICENSE upgrade to latest dependencies (#2983) 2020-10-28 19:22:34 -07:00
tutorials/katacoda adding katacoda tutorials (#3142) 2021-03-30 10:30:21 -07:00
vendor upgrade to latest dependencies (#3331) 2021-03-17 15:09:54 -07:00
.gitattributes Add .gitattributes for docs (#3138) 2021-01-28 21:32:30 -08:00
.gitignore ignore some java related files (#3015) 2020-11-07 07:10:08 -08:00
.wokeignore Ignore false-positive divisive language flagging (#3033) 2020-11-12 08:45:00 -08:00
CONTRIBUTING.md Hide CONTRIBUTING.md from the website (#3354) 2021-03-17 14:58:00 -07:00
DEVELOPMENT.md Added the link to run website locally from our README to our DEVELOPMENT (#3380) 2021-03-23 11:20:18 -07:00
LICENSE Add license footer and text (#204) 2018-07-19 12:05:32 -07:00
OWNERS Clarifying Docs contributor roles (#958) 2019-03-13 19:12:45 -07:00
OWNERS_ALIASES Update OWNERS_ALIASES (#3281) 2021-03-16 07:14:42 -07:00
README.md New blog template and update doc template (#3341) 2021-03-12 05:59:28 -08:00
_index.html Add a test for "index.md" frontmatter and fix the repo to match (#2377) 2020-05-15 08:41:02 -07:00
background.png Merge website files into Master (#1025) 2019-03-20 13:48:47 -07:00
doc-releases.md Drop unnecessary occurrences of master (#3333) 2021-03-11 05:08:26 -08:00
go.mod upgrade to latest dependencies (#3331) 2021-03-17 15:09:54 -07:00
go.sum upgrade to latest dependencies (#3331) 2021-03-17 15:09:54 -07:00
katacoda.yaml adding katacoda tutorials (#3142) 2021-03-30 10:30:21 -07:00
search.md Format markdown (#1070) 2019-03-24 21:12:49 -07:00
smoketest.md Drop unnecessary occurrences of master (#3333) 2021-03-11 05:08:26 -08:00
template-blog-entry.md New blog template and update doc template (#3341) 2021-03-12 05:59:28 -08:00
template-docs-page.md New blog template and update doc template (#3341) 2021-03-12 05:59:28 -08:00

README.md

Knative documentation

Welcome to the source file repository for our documentation on https://knative.dev.

Website

The Knative documentation website is built with hugo templates in Knative Website Repo.

View published documentation

View all Knative documentation and walk-through our code samples on the website.

The Knative website includes versioned docs for recent releases, the Knative blog, links to all community resources, as well as Knative governance and contributor guidelines.

Run website locally

Refer to this doc in the website repo.

Website source files

Source files for the documentation on the website are located within the /docs directory of this repo.

If you want to contribute a fix or add new content to the documentation, you can navigate through this repo or use the Edit this page on each of the pages of the website.

Before you can contribute, first start by reading the Knative contributor guidelines and learning about our community and requirements. In addition to reading about how to contribute to the docs, you should take a moment to learn about the Knative code of conduct, governance, values, and the various working groups and committees.

Knative community and contributor guidelines

Source files for all Knative community and governance topics are located separately in the knative/community repo.

Documentation versions for Knative releases

Each release of the Knative docs are available in the website (starting with 0.3) and their source files are all stored in branches of this repo.

Contributing

We're excited that you're interested in contributing to the Knative documentation! Check out the resources below to get started.

Getting started

  • How to contribute -- Contains information about how to contribute and outlines the roles for Docs contributors.

  • New content templates:

    • Documentation -- Instructions and a template that you can use to help you add new documentation.
    • Blog -- Instructions and a template that you can use to help you post to the Knative blog.

Getting help

  • #docs on the Knative Slack -- The #docs channel is the best place to go if you have questions about making changes to the documentation. We're happy to help!

  • Documentation working group -- Come join us in the working group to meet other docs contributors and ask any questions you might have.

Help and support

Your help and feedback is always welcome!

If you find an issue let us know, either by clicking the Create Issue on any of the website pages, or by directly opening an issue here in the repo.

If you have a question that you can't find an answer to, we would also like to hear about that too. In addition to our docs, you can also reach out to the community for assistance. For example, ask a documentation specific question on the #docs channel in Slack.

Also see the Knative community resource page for a list of all the available community resources, including links to the various community discussion groups for both development as well as troubleshooting.