diff --git a/README.md b/README.md
index 1206aef..7572730 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,19 @@
# kube-rs website
[![release](https://github.com/kube-rs/website/actions/workflows/release.yml/badge.svg)](https://github.com/kube-rs/website/actions/workflows/release.yml)
-
-Markdown resources and scripts for generating the [kube.rs](https://kube.rs) website.
+Markdown documents and scripts for generating the [kube.rs](https://kube.rs) website.
Hosted on [github pages](https://kube-rs.github.io/website).
## Setup
-This repo uses [foam](https://foambubble.github.io/foam/) + [`mkdocs`](https://www.mkdocs.org/) with [mkdocs-material](https://squidfunk.github.io/mkdocs-material/).
-
-To browse locally in `code`; [clone + install recommended extensions](https://foambubble.github.io/foam/#getting-started) to browse with [markdown links](https://marketplace.visualstudio.com/items?itemName=tchayen.markdown-links).
+This repo uses [`mkdocs`](https://www.mkdocs.org/) with [mkdocs-material](https://squidfunk.github.io/mkdocs-material/) and wiki style markdown cross-links.
+## Editing
To preview the webpage install requirements in a virtualenv and run `mkdocs serve`.
+Wiki links work locally given something like the [marksman markdown language server](https://github.com/artempyanykh/marksman), or through [foam](https://foambubble.github.io/foam/) for vs code with the recommended extensions in this repo.
+
## Organisation
The [mkdocs.yml](./mkdocs.yml) file's `nav` section dictates the structure of the webpage.
diff --git a/docs/index.md b/docs/index.md
index 571d36f..3560662 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -2,8 +2,13 @@
hide:
- navigation
- toc
+ #- path (insiders)
---
+
+
@@ -14,6 +19,28 @@ These crates build upon Kubernetes [apimachinery](https://github.com/kubernetes/
-[:fontawesome-solid-book: Getting Started](getting-started){ .md-button align=left } [:fontawesome-brands-discord: Community](https://discord.gg/tokio){ .md-button align=left } [:material-language-rust: Crates](https://crates.io/crates/kube){ .md-button align=left } [:material-github: Github](https://github.com/kube-rs){ .md-button align=left }
+
+[:fontawesome-solid-book: Getting Started](getting-started){ .md-button align=left } [:fontawesome-brands-github-alt: Q&A](https://github.com/kube-rs/kube/discussions){ .md-button align=left } [:material-language-rust: Crates](https://crates.io/crates/kube){ .md-button align=left } [:material-github: Github](https://github.com/kube-rs){ .md-button align=left } [:fontawesome-brands-discord: Community](https://discord.gg/tokio){ .md-button align=left }
+
+
diff --git a/mkdocs.yml b/mkdocs.yml
index d6345c6..b064526 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -7,7 +7,7 @@ repo_url: https://github.com/kube-rs/kube
repo_name: kube
# NB: edit uri won't work well with sync system if we don't have canonical docs in the same repo as the site
#edit_uri: edit/main/docs
-edit_uri: ''
+edit_uri: 'https://github.com/kube-rs/website/edit/main/docs'
theme:
icon:
repo: fontawesome/brands/github
@@ -39,6 +39,8 @@ theme:
- navigation.sections
- navigation.instant
- navigation.tracking
+ - navigation.prune
+ - content.action.edit
# NB: Maintaining the nav list is not necessary, but is needed to reorder.
# Generated from "fd .md ." in docs/ folder.
@@ -60,19 +62,21 @@ nav:
- upgrading.md
- Controllers:
- - controllers/intro.md
- - controllers/object.md
- - controllers/reconciler.md
- - controllers/application.md
- - controllers/observability.md
- - controllers/relations.md
- - controllers/gc.md
- - controllers/schemas.md
- - controllers/optimization.md
- - controllers/streams.md
- - controllers/testing.md
- - controllers/security.md
- - controllers/internals.md
+ Concepts:
+ - controllers/intro.md
+ - controllers/object.md
+ - controllers/reconciler.md
+ - controllers/application.md
+ - controllers/relations.md
+ - controllers/gc.md
+ - controllers/schemas.md
+ Advanced:
+ - controllers/testing.md
+ - controllers/observability.md
+ - controllers/optimization.md
+ - controllers/security.md
+ - controllers/streams.md
+ - controllers/internals.md
#- comunity.md
#- proposal-process.md