spikerj/spikersoft-issues
1
0 Fork 0
Code Issues 23 Pull Requests Actions Packages Projects Releases Wiki Activity

# [QoL Improvement] Add Introductory Lessons and Consistent Layout for Assembly Section #1144

New Issue
Closed
opened 2026-09-20 04:34:33 +00:00 by enjin2310 · 5 comments
enjin2310 commented 2026-09-20 04:34:33 +00:00
Copy link
Copy source

Summary

In Learn → Coding → Languages → Assembly, the section currently opens directly into the Assembly Playground, bypassing introductory lessons. This breaks the learning flow and visual consistency established in other language sections (e.g., JavaScript, Python), where users first encounter theoretical lessons before entering the interactive sandbox.

Issue Description

When accessing the Assembly section, users are taken straight to the playground environment for hands-on coding. Unlike other language modules, there are no initial theoretical or guided lessons introducing the language fundamentals. Additionally, the Lessons panel on the left is missing, disrupting the unified design and navigation experience across the learning platform.

Environment

Property Value
Application SpikerSoft Learn
Module Learn → Coding → Languages → Assembly
Environment Production
Browser Firefox
Operating System Windows 11
Version v2026.09.20a
Device Desktop

Preconditions

User navigates to Learn → Coding → Languages → Assembly.

Steps to Reproduce

  1. Open SpikerSoft Learn.
  2. Navigate to Coding → Languages → Assembly.
  3. Observe that the page loads directly into the Assembly Playground instead of showing introductory lessons.
  4. Compare with other language sections (e.g., JavaScript), which display a Lessons panel and theoretical content before the sandbox.

Expected Result

  • The Assembly section should begin with introductory lessons explaining basic concepts, syntax, and environment setup.
  • The Lessons panel should remain visible on the left side, maintaining design consistency with other language modules.
  • The user should progress naturally from theory to practice.

Actual Result

  • The section opens directly into the playground.
  • No theoretical lessons are shown.
  • The Lessons panel is missing, breaking layout uniformity.

Evidence

  • The first two screenshots show the current Assembly Playground layout without the Lessons panel.
  • The third screenshot shows the JavaScript section with the expected layout and lesson flow.

Impact

  • Reduces educational coherence and user onboarding quality.
  • Makes the Assembly section feel disconnected from the rest of the learning platform.
  • Negatively affects user experience and design consistency.

Frequency

Always

Reproducibility

100%

Severity

Medium

Suggested Improvement

  • Add introductory lessons for Assembly (e.g., “What is Assembly?”, “Basic Syntax”, “Registers and Memory”).
  • Restore the Lessons panel on the left side for navigation and progress tracking.
  • Maintain consistent layout and design across all language sections to unify the learning experience.
## Summary In **Learn → Coding → Languages → Assembly**, the section currently opens directly into the **Assembly Playground**, bypassing introductory lessons. This breaks the learning flow and visual consistency established in other language sections (e.g., JavaScript, Python), where users first encounter theoretical lessons before entering the interactive sandbox. ## Issue Description When accessing the **Assembly** section, users are taken straight to the playground environment for hands-on coding. Unlike other language modules, there are no initial theoretical or guided lessons introducing the language fundamentals. Additionally, the **Lessons** panel on the left is missing, disrupting the unified design and navigation experience across the learning platform. ## Environment | Property | Value | |-----------|--------| | Application | SpikerSoft Learn | | Module | Learn → Coding → Languages → Assembly | | Environment | Production | | Browser | Firefox | | Operating System | Windows 11 | | Version | v2026.09.20a | | Device | Desktop | ## Preconditions User navigates to **Learn → Coding → Languages → Assembly**. ## Steps to Reproduce 1. Open **SpikerSoft Learn**. 2. Navigate to **Coding → Languages → Assembly**. 3. Observe that the page loads directly into the **Assembly Playground** instead of showing introductory lessons. 4. Compare with other language sections (e.g., JavaScript), which display a **Lessons** panel and theoretical content before the sandbox. ## Expected Result - The **Assembly** section should begin with introductory lessons explaining basic concepts, syntax, and environment setup. - The **Lessons** panel should remain visible on the left side, maintaining design consistency with other language modules. - The user should progress naturally from theory to practice. ## Actual Result - The section opens directly into the playground. - No theoretical lessons are shown. - The **Lessons** panel is missing, breaking layout uniformity. ## Evidence - The first two screenshots show the current **Assembly Playground** layout without the **Lessons** panel. - The third screenshot shows the **JavaScript** section with the expected layout and lesson flow. ## Impact - Reduces educational coherence and user onboarding quality. - Makes the Assembly section feel disconnected from the rest of the learning platform. - Negatively affects user experience and design consistency. ## Frequency Always ## Reproducibility 100% ## Severity Medium ## Suggested Improvement - Add introductory lessons for Assembly (e.g., “What is Assembly?”, “Basic Syntax”, “Registers and Memory”). - Restore the **Lessons** panel on the left side for navigation and progress tracking. - Maintain consistent layout and design across all language sections to unify the learning experience.
Screenshot 2026-09-20 002908.png
193 KiB
Screenshot 2026-09-20 002908.png
spikerj commented 2026-09-21 20:38:09 +00:00
Owner
Copy link
Copy source

The Assembly lessons are already there. Opening Assembly from the coding menu asks the page to resume a lesson, and the Assembly page was ignoring that request, so it opened the empty playground and hid the lessons panel. JavaScript honors the same request, which is why that page shows the panel.

A fix is up that opens the first unfinished lesson (or the lesson you last had open) and shows the lessons list: spikerj/spikersoft-angular#1174

It is still marked WIP until the tests finish. This does not add a new “What is Assembly?” course — the existing lessons should appear once this is on a build you can retest.

The Assembly lessons are already there. Opening Assembly from the coding menu asks the page to resume a lesson, and the Assembly page was ignoring that request, so it opened the empty playground and hid the lessons panel. JavaScript honors the same request, which is why that page shows the panel. A fix is up that opens the first unfinished lesson (or the lesson you last had open) and shows the lessons list: https://git.spikersoft.com/spikerj/spikersoft-angular/pulls/1174 It is still marked WIP until the tests finish. This does not add a new “What is Assembly?” course — the existing lessons should appear once this is on a build you can retest.
spikerj commented 2026-09-21 20:54:19 +00:00
Owner
Copy link
Copy source

The frontend tests passed (lint, typecheck, and the SpikerSoft test suite). The pull request is no longer marked WIP: spikerj/spikersoft-angular#1174

It is not merged yet. Once it is on a build, opening Learn → Coding → Assembly while signed in should show the lessons panel and the first unfinished lesson.

The frontend tests passed (lint, typecheck, and the SpikerSoft test suite). The pull request is no longer marked WIP: https://git.spikersoft.com/spikerj/spikersoft-angular/pulls/1174 It is not merged yet. Once it is on a build, opening Learn → Coding → Assembly while signed in should show the lessons panel and the first unfinished lesson.
spikerj commented 2026-09-21 21:19:16 +00:00
Owner
Copy link
Copy source

This is merged to master as 8abb3f45 (spikerj/spikersoft-angular#1174).

On a build that contains that merge, sign in and open Learn → Coding → Assembly. The lessons panel should be on the left, and the first unfinished lesson should be open. Leaving the lesson should return to the playground without immediately jumping back into the lesson.

This is merged to master as `8abb3f45` (https://git.spikersoft.com/spikerj/spikersoft-angular/pulls/1174). On a build that contains that merge, sign in and open Learn → Coding → Assembly. The lessons panel should be on the left, and the first unfinished lesson should be open. Leaving the lesson should return to the playground without immediately jumping back into the lesson.
spikerj commented 2026-09-21 21:39:27 +00:00
Owner
Copy link
Copy source

The frontend deploy for that merge finished. Retest on v2026.09.21.4905 (commit 8abb3f45). Sign in, then open Learn → Coding → Assembly. The lessons panel should be on the left and the first unfinished lesson should be open.

The frontend deploy for that merge finished. Retest on **v2026.09.21.4905** (commit `8abb3f45`). Sign in, then open Learn → Coding → Assembly. The lessons panel should be on the left and the first unfinished lesson should be open.
spikerj commented 2026-09-27 05:06:59 +00:00
Owner
Copy link
Copy source

Closing in the 2026-09-27 tracker sweep — already implemented.

Fixed by spikerj/spikersoft-angular#1174 (deployed in v2026.09.21.4905): opening Learn -> Coding -> Assembly while signed in now opens the first unfinished lesson with the lessons panel on the left instead of the bare playground. Please reopen if a retest still shows the playground without the panel.

Reopen if this still needs work.

Closing in the 2026-09-27 tracker sweep — already implemented. Fixed by spikerj/spikersoft-angular#1174 (deployed in v2026.09.21.4905): opening Learn -> Coding -> Assembly while signed in now opens the first unfinished lesson with the lessons panel on the left instead of the bare playground. Please reopen if a retest still shows the playground without the panel. Reopen if this still needs work.
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
agentic
Actionable surfaced by the agentic architecture & security review
 bug
Something is not working
 duplicate
This issue or pull request already exists
 enhancement
New feature
 epic
Cross-repo epic — children live in per-repo trackers
 help wanted
Need some help
 invalid
Something is wrong
 question
More information is needed
 sonarqube
Code quality issue surfaced by SonarQube (bug / code smell)
 wontfix
This won't be fixed
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
spikerj (Joseph Spiker)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: spikerj/spikersoft-issues#1144