diff --git a/content/en/cloud/academy/creating-your-learning-path/index.md b/content/en/cloud/academy/creating-your-learning-path/index.md index fdee8f111..a7f175fbb 100644 --- a/content/en/cloud/academy/creating-your-learning-path/index.md +++ b/content/en/cloud/academy/creating-your-learning-path/index.md @@ -170,7 +170,16 @@ Enhance your course with images and other visual aids. The recommended and stand For all assets, please use the Page Bundling method. It simplifies asset management by co-locating images with the Markdown files that use them. {{< /alert >}} -**How to Add an Image** +### Size Limits for Embedded Media +While there's no hard-coded size limit, we enforce these practical constraints: +| Media Type | Recommended Max Size | Impact Beyond Limit | +|------------|----------------------|------------------------------| +| Video | 50 MB | Slow builds, CI failures | +| Image | 5 MB | Hugo memory overflow | +| PDF | 20 MB | Browser loading delays | + + +### How to Add an Image 1. Place your image file (e.g., `hugo-logo.png`) in the **same directory** as your Markdown file (e.g., `01-pods.md`). @@ -184,18 +193,44 @@ For all assets, please use the Page Bundling method. It simplifies asset managem The `usestatic` shortcode is **deprecated** and should not be used! {{< /alert >}} -**How to Add a Video** +### How to Add a Video + +**Page Bundling (Recommended)** +```markdown + +``` -```text -{{}} -