Skip to content

Commit a42c473

Browse files
authored
Update index.md
Signed-off-by: Zihan Kuang <127078886+zihanKuang@users.noreply.github.com>
1 parent 1b44f98 commit a42c473

File tree

1 file changed

+12
-7
lines changed
  • content/en/cloud/academy/creating-your-learning-path

1 file changed

+12
-7
lines changed

content/en/cloud/academy/creating-your-learning-path/index.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -281,14 +281,14 @@ This action will automatically trigger the workflow, and your content will be de
281281
282282
## 6. Ongoing Maintenance and Updates
283283
284-
The Layer5 Academy uses a maintained Hugo theme called [`academy-theme`](https://github.com/layer5io/academy-theme). As improvements are made to the theme, it is important to keep your local copy up to date to benefit from the latest features and fixes.
284+
The [`academy-theme`](https://github.com/layer5io/academy-theme) provides the core layout, style, and features for your learning path. Regularly updating it ensures you benefit from the latest improvements and bug fixes.
285285
286286
To upgrade to the latest theme version, run:
287287
```bash
288288
make theme-upgrade
289289
```
290290
291-
This will trigger a sequence that updates the theme dependencies and applies the latest modules. The output below shows an example of what you might see:
291+
You will see output similar to this as Hugo fetches the new modules:
292292
```bash
293293
hugo mod get -u
294294
hugo: collected modules in 1707 ms
@@ -297,12 +297,17 @@ go: upgraded github.com/layer5io/academy-theme v0.1.5 => v0.1.6
297297
go: upgraded github.com/twbs/bootstrap v5.3.6+incompatible => v5.3.7+incompatible
298298
```
299299
300-
#### When should you upgrade the theme?
300+
{{< alert type="info" title="When to Update?" >}}
301+
It's a good practice to update the theme before creating a new release or when you notice that your local preview is missing recent design changes.
302+
{{< /alert >}}
303+
304+
### Clearing the Local Cache for Troubleshooting
301305

302-
- Before creating a release, to ensure you are using the most up-to-date theme.
303-
- If your preview or build seems outdated or missing recent design improvements.
304-
- After any update to the `academy-theme` repository is announced.
305-
> Run `hugo mod graph` to inspect which version of the theme you are currently using.
306+
If you encounter unexpected formatting issues or your content doesn't update correctly during local development, your build cache might be stale. Use the `make clean` command to resolve this.
307+
This command first deletes the local build cache (`public` directory) and then restarts the development server, ensuring you are previewing a fresh build of your content.
308+
```bash
309+
make clean
310+
```
306311
307312
## Frequently Asked Questions
308313

0 commit comments

Comments
 (0)