layer5io / layer5io/academy-example
feat: incorporate `org-id` shortcode into content
Open
@leecalcote is already working on this.
Since Jun 23, 2026.
kind/enhancement
- Dominant language
- Makefile
- Stars
- 26
- Forks
- 38
- PR merge metrics
- No merged PRs in 30d
Description
Summary
A new {{< org-id >}} shortcode has been added to layer5io/academy-theme. This shortcode renders the current organization's UUID inline by reading it from the page's content path (content/<type>/<orgID>/...).
Desired Behavior
Wherever course or lab content directs learners to reference their organization ID — for example, when navigating the Meshery Cloud console, constructing API calls, or identifying their workspace — use {{< org-id >}} so the correct UUID is displayed automatically.
Usage:
Your organization ID is: {{</* org-id */>}}
Implementation
- Review lab, module, and course intro pages for places that say "your organization," reference an org UUID, or direct learners to the cloud console.
- Replace hardcoded IDs or placeholder text with
{{< org-id >}}. - Add the shortcode to a content formatting example page (
content/content-formatting-examples/academy-theme/org-id.md) to document its usage.
Acceptance Criteria
-
{{< org-id >}}shortcode is used in at least one lab or module intro page. - A formatting example page exists at
content/content-formatting-examples/academy-theme/org-id.md. - The shortcode renders the org UUID correctly when the page is inside a UUID-named directory.
Contributor Guide and Resources
- 📚 Instructions for contributing
- academy-example documentation site and source
- 🙋🏾🙋🏼 Questions: Layer5 Discussion Forum and Layer5 Community Slack
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.