554d71d85e
* Installation Doc Updates Improve installation guidance * Formatting fix * Update docs/install/README.md link fix Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com> * Update docs/install/README.md link fix Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com> * link fix and table update More writing * Update README.md Misc edits * Update README.md Minor edits * Adding install-kn to PR Consolidating CLI installations into this this topic. * Update install-kn.md Changing red bug alert to important The old syntax was: ??? bug "Having issues upgrading `kn` to Homebrew?" * Update install-kn (snippet) Removed alert formatting * Added quickstart-install.md Various edits * Fixes and reviewed edits Made Evan suggestions, table column test, spelling fixes * Update quickstart-install.md link fix * Update README.md Replaced the table with a bulleted list approach. * Update README.md Put back the table * Added serving and eventing install topics Updated topics per effort - consolidating guidance * Link fixes * Made Evan's edits * Various updates All files added for this PR. * Link fix * Formatting fixes * Formatting and consistency fix * Update docs/install/operator/knative-with-operator-cli.md Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com> * Update docs/client/install-kn.md Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com> --------- Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com> |
||
|---|---|---|
| .github | ||
| code-samples | ||
| config | ||
| contribute-to-docs | ||
| cookie-consent/js | ||
| docs | ||
| golang | ||
| hack | ||
| overrides | ||
| reports | ||
| test | ||
| third_party/VENDOR-LICENSE | ||
| tools/redir-gen | ||
| vendor | ||
| .gitattributes | ||
| .gitignore | ||
| .gitpod.yml | ||
| .wokeignore | ||
| CODE-OF-CONDUCT.md | ||
| CONTRIBUTING.md | ||
| DEVELOPMENT.md | ||
| LICENSE | ||
| LICENSE-docs | ||
| OWNERS | ||
| OWNERS_ALIASES | ||
| README.md | ||
| SECURITY.md | ||
| _index.html | ||
| background.png | ||
| doc-releases.md | ||
| go.mod | ||
| go.sum | ||
| katacoda.yaml | ||
| mkdocs.yml | ||
| netlify.toml | ||
| requirements.txt | ||
| search.md | ||
README.md
| _build | ||||
|---|---|---|---|---|
|
(This guide only appears on GitHub, not the website, because it intentionally does not include YAML front-matter.)
Knative documentation
Welcome to the source file repository for our documentation on https://knative.dev.
Website
The Knative documentation website is built using Material for MkDocs.
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 the website locally
For instructions, refer to Knative's docs contributor guide.
Website source files
Source files for the documentation on the website are located within the
/docs directory of this repo.
Documentation versions for Knative releases
Each release of the Knative docs is available on the website (starting with 0.3) and their source files are all stored in branches of this repo.
Contributing to docs
We're excited that you're interested in contributing to the Knative documentation! Check out the resources below to get started.
If you are interested in contributing to Knative more broadly, please check out CLOTRIBUTOR for a list of all the help wanted issues in Knative.
Getting started
If you want to contribute a fix or add new content to the documentation, you can
navigate through the /docs repo or use the Edit this page pencil icon 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.
To help you get started, see the following resources:
-
Knative docs contributor's guide -- Contains information about how to contribute.
-
New content templates:
Getting help
-
#knative-documentation on the CNCF Slack -- The #knative-documentation 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 please 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. In addition to our docs, you can also reach out to the
community for assistance. For example, ask a documentation-specific question on
the #knative-documentation channel in Slack.
Also see the Knative community resource pages for a list of all the available community resources, including links to the various community discussion groups for both development as well as troubleshooting.