layer5io / layer5io/academy-example

feat: incorporate `org-id` shortcode into content

Open
#146 0 comments 0 reactions 1 assignee View on GitHub

@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
  1. Review lab, module, and course intro pages for places that say "your organization," reference an org UUID, or direct learners to the cloud console.
  2. Replace hardcoded IDs or placeholder text with {{< org-id >}}.
  3. 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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.