diff --git a/README.md b/README.md index ce850d50d1..42f9a77b24 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ The Knative documentation website is built using [Material for MkDocs](https://s ### View published documentation -View all Knative documentation and walk-through our code samples on the +View all Knative documentation and walk through our code samples on the [website](https://knative.dev). The Knative website includes versioned docs for recent releases, the Knative @@ -26,7 +26,7 @@ contributor guidelines. ### Run the website locally -For instructions, see Knative's [docs contributor guide](contribute-to-docs/getting-started/previewing-docs-locally.md). +For instructions, refer to Knative's [docs contributor guide](contribute-to-docs/getting-started/previewing-docs-locally.md). ### Website source files @@ -35,7 +35,7 @@ Source files for the documentation on the website are located within the ### Documentation versions for Knative releases -Each release of the Knative docs is available in the website (starting with +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](doc-releases.md). @@ -86,13 +86,13 @@ To help you get started, see the following resources: Your help and feedback is always welcome! -If you find an issue let us know, either by clicking the `Create Issue` on any +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](https://github.com/knative/docs/issues/new/choose) 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 +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](https://cloud-native.slack.com/archives/C04LY5G9ED7). Also see the [Knative community resource pages](https://knative.dev/docs/community/)