Skip to content

Cleanup content#378

Open
lucj wants to merge 18 commits intolayer5io:masterfrom
lucj:master
Open

Cleanup content#378
lucj wants to merge 18 commits intolayer5io:masterfrom
lucj:master

Conversation

@lucj
Copy link
Copy Markdown
Contributor

@lucj lucj commented Apr 8, 2026

This is currently a WIP

This brings the latest version of the Exoscale learning content to the Layer5 Academy.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 8, 2026

🚀 Preview deployment: https://layer5io.github.io/exoscale-academy/pr-preview/pr-378/

Note: Preview may take a moment (GitHub Pages deployment in progress). Please wait and refresh. Track deployment here

@aabidsofi19
Copy link
Copy Markdown
Contributor

@lucj this looks good.

For the 12 newly added learning paths, you’ll need to generate their IDs in the cloud console and then use those IDs in the _index.md files.

Also, I noticed that most learning paths (except the workshops) are currently single-page. A proper learning path should have at least one dedicated page inside it. You can handle this in one of two ways:

Create a new leaf page with type: page inside each learning path, move the current index.md content into that page, and keep _index.md only for metadata (title, banner, tags, categories, etc.).
Alternatively, you could group these single-page learning paths under a single parent learning path, with each one as a separate course/page.

In general, _index.md should not contain the actual learning content—it should only hold metadata for the learning path.

For the learning and certification items that were removed, no action is needed in the console. They will be archived automatically.


[https://kubernetes.io/docs/reference/kubectl/generated/kubectl_delete/](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_delete/)

## Solution
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Follow the old inline ## Exercise / ## Documentation / ## Solution, while new material in operations and challenges splits solutions into dedicated pages.
Example

Image

Use a consistent layout

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If this is ok for you, I'd update the exercises / solutions splits after the whole thing is released.


4. Delete the Pod

## Documentation
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use a consistent layout

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure to get this one.

@@ -0,0 +1,96 @@
---
title: Solution
Copy link
Copy Markdown
Contributor

@CodexRaunak CodexRaunak Apr 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use a specific title, this works in breadcrumbs, but it is weak in standalone navigation and search. Example "Challenge 4 Solution"

Image

Another pagination example (causing ambiguity)
image

Copy link
Copy Markdown
Contributor

@CodexRaunak CodexRaunak left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


## Private Network

### Private Network
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

duplicates the section heading with two different heading levels


## Load Balancing

### Load Balancing
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

duplicates the section heading with two different heading levels

@lucj
Copy link
Copy Markdown
Contributor Author

lucj commented Apr 27, 2026

@lucj this looks good.

For the 12 newly added learning paths, you’ll need to generate their IDs in the cloud console and then use those IDs in the _index.md files.

Also, I noticed that most learning paths (except the workshops) are currently single-page. A proper learning path should have at least one dedicated page inside it. You can handle this in one of two ways:

Create a new leaf page with type: page inside each learning path, move the current index.md content into that page, and keep _index.md only for metadata (title, banner, tags, categories, etc.). Alternatively, you could group these single-page learning paths under a single parent learning path, with each one as a separate course/page.

In general, _index.md should not contain the actual learning content—it should only hold metadata for the learning path.

For the learning and certification items that were removed, no action is needed in the console. They will be archived automatically.

ok, I use index.md with a "page" type for the content, and _index.md for the metadata only.

@lucj
Copy link
Copy Markdown
Contributor Author

lucj commented Apr 27, 2026

I've updated the relative weights of the learning paths, but they are not listed in the correct order in the left menu and in the page. Any idea why ?

Capture d’écran 2026-04-27 à 16 35 00

@CodexRaunak
Copy link
Copy Markdown
Contributor

Hey @lucj
We have released another version of the academy-theme, please fetch the latest changes from upstream, it includes an instructor toolkit, where you can verify that the IDs are registered with the academy.

Here's is the demonstration of it:

Comment thread data/hextra/icons.yaml
@@ -0,0 +1,55 @@
# Kubernetes
pod: >
Copy link
Copy Markdown
Contributor

@CodexRaunak CodexRaunak Apr 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file + folder data can be deleted as we have added the icons in the academy-theme v0.4.7

@lucj
Copy link
Copy Markdown
Contributor Author

lucj commented Apr 27, 2026

Hey @lucj We have released another version of the academy-theme, please fetch the latest changes from upstream, it includes an instructor toolkit, where you can verify that the IDs are registered with the academy.

Here's is the demonstration of it:

hey @CodexRaunak, I'm not sure to get this right as I've created the IDs for each of the 3 workshops, but the inspector tells me there are not there.

Capture d’écran 2026-04-27 à 17 04 33 Capture d’écran 2026-04-27 à 17 04 43

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking good, @lucj. Ideally, this is a Meshery Design, embedded in the pages for both an enhanced learner experience - both getting to interact with the design/components as well as, ultimately, being able to deploy the design.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lucj @CodexRaunak, the currently published form of the workshop and of the rest of the Exoscale content has a number of embedded Meshery designs. It'd be great to see the continuity of that work (for it not to be lost).

Here are a couple of examples from the current workshop content - https://exoscale.layer5.io/academy/learning-paths/1e2a8e46-937c-47ea-ab43-5716e3bcab2e/end-to-end-kubernetes/kubernetes-workshop/workshop/concepts/#how-to-access-a-cluster

id: "6bb2ae92-89d6-4e2b-aac2-74512828b68d"
level: "beginner"
---
Understand the basic principles of containers and container orchestration, as well as why Kubernetes and containers are beneficial.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This paragraph is same as the description, causing duplicate text displayed.
Either please change the description or the paragraph.

Image


Many people have a complex job building, testing, and running systems based on old concepts and technology in today's IT — the results you can see below (Experiences we want to change!). Modern ways to build, test, and run IT systems are not adopted as broadly as possible. Hence, a lot of pain is still out there that we could ease by changing IT processes and utilizing the new ways.

![](containers.png "Why Containers?")
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Broken image reference, as not found in this leaf bundle.

#### BUILD - Life of a Developer
Here you see a developer who brought her code into production, only to find out that it didn't run like on her laptop ...

![](dev.png "")
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Broken image reference, as not found in this leaf bundle.

@CodexRaunak
Copy link
Copy Markdown
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants