diff --git a/content/en/charts/_index.md b/content/en/charts/_index.md
index cc0ce2671..8103e64f8 100644
--- a/content/en/charts/_index.md
+++ b/content/en/charts/_index.md
@@ -11,7 +11,7 @@ cascade:
{{< alert type="info" title="Repository Only">}}
This page only contains a brief synopsis of the Helm repository.
-
+
See the [Self-Hosted section](/cloud/self-hosted/) of the Layer5 Cloud documentation for deployment prerequisites, considerations, and instructions.
{{< /alert >}}
@@ -21,7 +21,7 @@ Contained in the Layer5 Helm repository is the [Meshery Remote Provider](https:/
## Chart Source
-
The source for this chart is located in the layer5io/meshery-cloud repository under install/kubernetes/.
+The source for this chart is located in the layer5io/meshery-cloud repository under
install/kubernetes/
.
{{< alert type="info" title="Complete Deployment Instructions">}}
Layer5 Cloud's Helm chart supports a number of [configuration options]({{[}})
diff --git a/content/en/cloud/getting-started/getting-started-with-layer5-account.md b/content/en/cloud/getting-started/getting-started-with-layer5-account.md
index 1dabb43f3..289bd81cc 100644
--- a/content/en/cloud/getting-started/getting-started-with-layer5-account.md
+++ b/content/en/cloud/getting-started/getting-started-with-layer5-account.md
@@ -52,7 +52,7 @@ Give your organization a name and a description. For more information, see "Crea
Workspaces are logical group of shared set of resources like environments, connections, credentials, infrastructural designs and more. Every user on Layer5 Cloud is part of at least one workspace. You can create your own workspace or join an existing one. By default you are the owner of the workspace you create. You can share access to resources in your workspaces through teams.
{{< alert type="info" >}}
-For more information, see [Workspaces](/cloud/workspaces/)
+For more information, see [Workspaces](/cloud/spaces/workspaces/)
{{< /alert >}}
Give your workspace a name and a description. For more information, see "Creating a workspace."
diff --git a/content/en/cloud/github-actions/_index.md b/content/en/cloud/github-actions/_index.md
index c5ed08153..dcd4005ea 100644
--- a/content/en/cloud/github-actions/_index.md
+++ b/content/en/cloud/github-actions/_index.md
@@ -10,7 +10,7 @@ Meshery GitHub Actions enhance your operational workflow by integrating git vers
## Meshery Github Actions
1. [Kanvas Snapshot](#kanvas-snapshot-github-action)
-2. [Performance Testing with Meshery](https://docs.meshery.io/guides/gitops-with-meshery)
+2. [Performance Testing with Meshery](https://docs.meshery.io/guides/infrastructure-management/gitops-with-meshery)
3. Archived: [Service Mesh Interface Conformance with Meshery](https://github.com/marketplace/actions/service-mesh-interface-conformance-with-meshery)
This methodology automates the synchronization of your actual infrastructure state with the desired state defined in your Git repository. Meshery enables GitOps by offering a comprehensive view of your infrastructure, allowing you to verify workload designs and Kubernetes cluster configurations before merging pull requests.
@@ -56,4 +56,4 @@ GitHub Actions provides a variety of events that can trigger workflows, allowing
You can create your own performance profiles to run repeatable tests with Meshery. You can configure this action to trigger with each of your releases, on every pull request. or any GitHub workflow trigger event. A sample configuration of the action is shown below.
-Read more about the Service Mesh Performance GitHub Action in the [Meshery documentation](https://docs.meshery.io/guides/gitops-with-meshery). [See action in GitHub Marketplace](https://github.com/marketplace/actions/performance-testing-with-meshery)
+Read more about the Service Mesh Performance GitHub Action in the [Meshery documentation](https://docs.meshery.io/guides/infrastructure-management/gitops-with-meshery). [See action in GitHub Marketplace](https://github.com/marketplace/actions/performance-testing-with-meshery)
diff --git a/content/en/cloud/self-hosted/white-labeling/_index.md b/content/en/cloud/self-hosted/white-labeling/_index.md
index 6f12535e6..c51cf0750 100644
--- a/content/en/cloud/self-hosted/white-labeling/_index.md
+++ b/content/en/cloud/self-hosted/white-labeling/_index.md
@@ -124,7 +124,7 @@ To set up a www or custom subdomain, such as `www.example.com` or `meshery.examp
In Layer5 Cloud, navigate to your Provider Organization.
-Under your Organization name, click Edit. If you cannot click the "Edit" action, verify that you are a [Provider Administrator](/cloud/security/roles/provider-admin-roles/).
+Under your Organization name, click Edit. If you cannot click the "Edit" action, verify that you are a [Provider Administrator](/cloud/security/roles).
Under "Custom domain", type your custom domain, then click Save. This will create a server configuration will require a reboot in order to take affect.
diff --git a/content/en/cloud/spaces/workspaces.md b/content/en/cloud/spaces/workspaces.md
index 5501f47ae..a7bc3ca83 100644
--- a/content/en/cloud/spaces/workspaces.md
+++ b/content/en/cloud/spaces/workspaces.md
@@ -62,7 +62,7 @@ Designs belong to only one Workspace at any given time. See [Meshery Designs](ht
- Same team can be assigned to multiple workspaces.
{{< alert type="info" >}}
-Teams offer control access to workspaces and to workspace resources such as environments and managed and unmanaged connections, See [Teams](../identity/teams)
+Teams offer control access to workspaces and to workspace resources such as environments and managed and unmanaged connections, See [Teams](/cloud/identity/teams).
{{< /alert >}}
### Connections
@@ -72,7 +72,7 @@ Teams offer control access to workspaces and to workspace resources such as envi
- Same connection can be assigned to multiple environments.
{{< alert type="info" >}}
-See [Connections](https://docs.meshery.io/concepts/connections) section for more information.
+See [Connections](https://docs.meshery.io/concepts/logical/connections) section for more information.
{{< /alert >}}
## Best Practices
diff --git a/content/en/kanvas/reference/contributing-to-docs.md b/content/en/kanvas/reference/contributing-to-docs.md
index b95066e73..7c8ebf826 100644
--- a/content/en/kanvas/reference/contributing-to-docs.md
+++ b/content/en/kanvas/reference/contributing-to-docs.md
@@ -9,7 +9,7 @@ aliases:
Welcome to the GitHub repository for Layer5's documentation website!
-The docs website is hosted at https://docs.layer5.io.
+The docs website is hosted at .
We use [Hugo](https://gohugo.io/) with the [google/docsy](https://github.com/google/docsy) theme for styling and site structure, and [Netlify](https://www.netlify.com/) to manage the deployment of the site.
@@ -21,21 +21,18 @@ Here's a quick guide to updating the docs:
2. Make your changes and send a pull request (PR).
-3. If you're not yet ready for a review, add "WIP" to the PR name to indicate it's a work in progress.
- Alternatively, you use the `/hold` [prow command](https://prow.k8s.io/command-help) in a comment to mark the PR as not ready for merge.
+3. If you're not yet ready for a review, add "WIP" to the PR name to indicate it's a work in progress.
-4. Wait for the automated PR workflow to do some checks.
+4. Wait for the automated PR workflow to do some checks.
When it's ready, you should see a comment like this: `deploy/netlify — Deploy preview ready!`
5. Click **Details** to the right of "Deploy preview ready" to see a preview of your updates.
6. Continue updating your doc and pushing your changes until you're happy with the content.
-7. When you're ready for a review, add a comment to the PR, remove any holds or "WIP" markers, and assign a reviewer/approver.
- See the [Layer5 contributor guide](https://layer5.io/community/handbook/contribution).
+7. When you're ready for a review, add a comment to the PR, remove any holds or "WIP" markers, and assign a reviewer/approver. See the [Layer5 contributor guide](https://layer5.io/community/handbook/contribution).
-If you need more help with the GitHub workflow, follow
-this [guide to a standard GitHub workflow](https://github.com/layer5io/docs/blob/master/CONTRIBUTING-gitflow.md).
+If you need more help with the GitHub workflow, follow this [guide to a standard GitHub workflow](https://github.com/layer5io/docs/blob/master/CONTRIBUTING-gitflow.md).
## Local development
@@ -45,12 +42,12 @@ This section will show you how to develop the website locally, by running a loca
To install Hugo, follow the [instructions for your system type](https://gohugo.io/getting-started/installing/).
-**NOTE:** we recommend that you use Hugo version `0.119.0`, as this is currently the version we deploy to Netlify.
+**NOTE:** we recommend that you use Hugo version `v0.140.2`, as this is currently the version we deploy to Netlify.
For example, using homebrew to install hugo on macOS or linux:
```bash
-# WARNING: this may install a newer version than `0.119.0`
+# WARNING: this may install a newer version than `v0.140.2`
brew install hugo
```
@@ -110,9 +107,9 @@ Follow the usual GitHub workflow of forking the repository on GitHub and then cl
## Menu structure
The site theme has one Hugo menu (`main`), which defines the top navigation bar. You can find and adjust the definition
-of the menu in the [site configuration file](https://github.com/layer5io/docs/blob/master/config.toml).
+of the menu in the [site configuration file](https://github.com/layer5io/docs/blob/master/hugo.toml).
-The left-hand navigation panel is defined by the directory structure under the [`docs` directory](https://github.com/layer5io/docs/tree/master/content/en/docs).
+The left-hand navigation panel is defined by the directory structure under the [`content/en` directory](https://github.com/layer5io/docs/tree/master/content/en).
A `weight` property in the _front matter_ of each page determines the position of the page relative to the others in the same directory.
The lower the weight, the earlier the page appears in the section.
@@ -129,7 +126,7 @@ weight = 1
## Docsy Theme
-We use the [Docsy](https://www.docsy.dev/) theme for the website.
+We use the [Docsy](https://www.docsy.dev/) theme for the website.
The theme files are managed with a [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules) in the `themes/docsy` directory.
**Do not change these files**, they are not actually inside this repo, but are part of the [google/docsy](https://github.com/google/docsy) repo.
@@ -151,27 +148,27 @@ the style guide for the Layer5 docs.
## Styling your content
-The theme holds its styles in the [`assets/scss` directory](https://github.com/layer5io/docs/tree/master/themes/docsy/assets/scss).
+The theme holds its styles in the [`assets/scss` directory](https://github.com/layer5io/docs/tree/master/assets/scss).
**Do not change these files**, they are not actually inside this repo, but are part of the [google/docsy](https://github.com/google/docsy) repo.
You can override the default styles and add new ones:
-* In general, put your files in the project directory structure under `website` rather than in the theme directory.
+* In general, put your files in the project directory structure under `website` rather than in the theme directory.
Use the same file name as the theme does, and put the file in the same relative position.
- Hugo looks first at the file in the main project directories, if present, then at the files under the theme directory.
+ Hugo looks first at the file in the main project directories, if present, then at the files under the theme directory.
For example, the Layer5 website's [`layouts/partials/navbar.html`](https://github.com/layer5io/docs/blob/master/layouts/partials/navbar.html)
overrides the theme's [`layouts/partials/navbar.html`](https://github.com/layer5io/docs/blob/master/themes/docsy/layouts/partials/navbar.html)
* You can update the Layer5 website's project variables in the [`_variables_project.scss` file](https://github.com/layer5io/docs/blob/master/assets/scss/_variables_project.scss).
- Values in that file override the [Docsy variables](https://github.com/layer5io/docs/blob/master/themes/docsy/assets/scss/_variables.scss).
+ Values in that file override the [Docsy variables](https://github.com/layer5io/docs/blob/master/themes/docsy/assets/scss/_variables.scss).
You can also use `_variables_project.scss` to specify your own values for any of the default [Bootstrap 4 variables](https://getbootstrap.com/docs/4.0/getting-started/theming/).
* Custom styles [`_styles_project` file](https://github.com/layer5io/docs/blob/master/assets/scss/_styles_project.scss)
Styling of images:
-* To see some examples of styled images, take a look at the OAuth setup page in the Layer5 docs.
+* To see some examples of styled images, take a look at the OAuth setup page in the Layer5 docs.
Search for `.png` in the [page source](https://raw.githubusercontent.com/layer5io/docs/master/content/en/docs/gke/deploy/oauth-setup.md).
* For more help, see the guide to
@@ -182,7 +179,7 @@ Styling of images:
The site's [front page](https://docs.layer5.io/):
-* See the [page source](https://github.com/layer5io/docs/blob/master/content/en/_index.html).
+* See the [page source](.
* The CSS styles are in the [project variables file](https://github.com/layer5io/docs/blob/master/assets/scss/_variables_project.scss).
@@ -192,17 +189,17 @@ The site's [front page](https://docs.layer5.io/):
## Using Hugo shortcodes
-Sometimes it's useful to define a snippet of information in one place and reuse it wherever we need it.
-For example, we want to be able to refer to the minimum version of various frameworks/libraries throughout the docs,
+Sometimes it's useful to define a snippet of information in one place and reuse it wherever we need it.
+For example, we want to be able to refer to the minimum version of various frameworks/libraries throughout the docs,
without causing a maintenance nightmare.
-For this purpose, we use Hugo's "shortcodes".
-Shortcodes are similar to Django variables. You define a shortcode in a file, then use a specific markup
+For this purpose, we use Hugo's "shortcodes".
+Shortcodes are similar to Django variables. You define a shortcode in a file, then use a specific markup
to invoke the shortcode in the docs. That markup is replaced by the content of the shortcode file when the page is built.
To create a shortcode:
-1. Add an HTML file in the `/docs/layouts/shortcodes/` directory.
+1. Add an HTML file in the `/docs/layouts/shortcodes/` directory.
The file name must be short and meaningful, as it determines the shortcode you and others use in the docs.
2. For the file content, add the text and HTML markup that should replace the shortcode markup when the web page is built.
@@ -242,17 +239,17 @@ Useful Hugo docs:
## Versioning of the docs
-For each stable release, we create a new branch for the relevant documentation.
+For each stable release, we create a new branch for the relevant documentation.
For example, the documentation for the v0.2 stable release is maintained in the [v0.2-branch](https://github.com/layer5io/docs/tree/v0.2-branch).
Each branch has a corresponding Netlify website that automatically syncs each merged PR.
The versioned sites follow this convention:
-* `docs.layer5.io` always points to the current *master branch*
+* `docs.layer5.io` always points to the current _master branch_
* `master.docs.layer5.io` always points to GitHub head
* `vXXX-YYY.docs.layer5.io` points to the release at vXXX.YYY-branch
-We also hook up each version to the dropdown on the website menu bar.
+We also hook up each version to the dropdown on the website menu bar.
For information on how to update the website to a new version, see the [Layer5 release guide](https://github.com/layer5io/docs/blob/master/docs_dev/releasing.md#releasing-a-new-version-of-the-website).
Whenever any documents reference any source code, you should use the version shortcode in the links, like so:
@@ -261,4 +258,4 @@ Whenever any documents reference any source code, you should use the version sho
https://github.com/layer5io/docs/blob/master/scripts/gke/deploy.sh
```
-This ensures that all the links in a versioned webpage point to the correct branch.
\ No newline at end of file
+This ensures that all the links in a versioned webpage point to the correct branch.
]