Skip to content

Reframe the Learn page as a role-based course journey - #21

Merged
il10241024 merged 1 commit into
mainfrom
learn-page-refresh
Sep 1, 2026
Merged

Reframe the Learn page as a role-based course journey#21
il10241024 merged 1 commit into
mainfrom
learn-page-refresh

Conversation

@sstimsu

@sstimsu sstimsu commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Why

The five courses appeared in the order they were written — the Studio
overview first, the executive overview fourth — so a visitor could not tell
which one was meant for them. The introduction described the catalogue
instead of helping anyone choose a starting point.

What changed

Introduction now names the three audiences and invites selection by role,
rather than listing what the courses cover.

Course order and numbering follow a progression: business value → platform
overview → building with Studio → using Gears → building Gears.

# Course Was
01 Constructor Fabric Overview for Executives 04, titled "Constructor Fabric: Overview for Executives"
02 Constructor Studio Overview 01
03 Constructor Studio for Developers 02, titled "Constructor for Developers"
04 Intro to Constructor Gears 03, titled "Constructor Gears for Beginners"
05 How to Build a Gear 05, titled "Constructor Gears for Contributors"

Descriptions rewritten for courses 01, 02, 04 and 05. The developer course
description is unchanged. The new text says what the learner gains; the old
text mostly enumerated the job titles each course had been scoped against —
one description ran to sixty words of role list before reaching its subject.

Removed the "Acronis Accelerate: The Journey to Autonomous IT" tile, as the
event has already taken place.

Preserved

Every enrollment link and Coming Soon status moved with its course, verified
card by card against HEAD:

Course Status
Executives enroll → …4-ab75efa961cc
Studio Overview enroll → …5-558cd42f5116
Developers enroll → …9-0be950659136
Intro to Gears Coming Soon ...
How to Build a Gear Coming Soon ...

Testing

Rendered locally at desktop, tablet and mobile widths: five cards in the
specified order, numbering 01–05 correct, the Acronis tile absent, and no
console errors beyond the pre-existing CookieYes warning that only appears on
localhost.

Not included

Three follow-ups left out to keep this to the requested scope — happy to fold
any of them in:

  • learn/acronis-accelerate-event.html is now orphaned: still on disk and
    reachable by URL, but nothing links to it.
  • ElementLinkCard is now dead code — the removed tile was its only use on
    this page.
  • The three page description meta tags still end with "and how to contribute",
    which described the old Course 05.

Created with the help of Claude Code

The page listed five courses in the order they happened to be written,
led by a Studio overview, with an executive overview fourth. A prospective
learner had no way to see which course was meant for them, and the
introduction described the catalogue rather than pointing anyone at a
starting place.

The courses are now ordered as a progression — executives, then the Studio
overview, then developers, then Gears from introduction to authoring — and
the introduction names the three audiences and invites the reader to pick
by role.

Three titles change to match: "Constructor for Developers" becomes
"Constructor Studio for Developers", "Constructor Gears for Beginners"
becomes "Intro to Constructor Gears", and "Constructor Gears for
Contributors" becomes "How to Build a Gear". Four descriptions are
rewritten to say what the learner gets rather than list the job titles the
course was scoped against.

Every enrollment link and Coming Soon status stays with its course.

Also removes the Acronis Accelerate tile: the event has taken place.

Done with the help of: Claude Opus 5

Signed-off-by: sstimsu <timsus@gmail.com>
@sstimsu
sstimsu requested a review from a team as a code owner September 1, 2026 08:43
@coderabbitai

coderabbitai Bot commented Sep 1, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: e43bd1b5-679b-4d5e-ba53-b857263a108b


Comment @coderabbitai help to get the list of available commands.

@constructorfabric

Copy link
Copy Markdown

Preview deployment is ready:

https://constructorfabric.github.io/website-previews/pr-21/

This preview is built from the latest commit on this PR. It is regenerated automatically on every push. Old previews are cleaned up after 30 days.

@il10241024
il10241024 merged commit 8969577 into main Sep 1, 2026
3 checks passed
@sstimsu
sstimsu deleted the learn-page-refresh branch September 2, 2026 04:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants