# Learning Workspaces

This directory contains learning workspaces. Treat each subdirectory under `learning/` as a potentially web-published teaching bundle, not just local notes.

## Web Publishing

- The `learning/` directory is served on the web at `https://learn.maio.cz/`.
- A workspace at `learning/{slug}/` is publicly reachable at `https://learn.maio.cz/{slug}/`.
- When creating a new learning workspace with HTML lessons, create `learning/{slug}/index.html` as the primary web entry point.
- The `index.html` should be a clean, mobile-friendly HTML rozcestník with links to lessons, reference documents, and any recommended starting order.
- Prefer relative links inside the workspace, for example `lessons/0001-topic.html`, `reference/0001-cheatsheet.html`, and `../index.html` from lesson files.
- Add the public URL to the workspace `README.md`, for example `https://learn.maio.cz/{slug}/`.
- Do not open newly created lessons in a browser; provide the public link to the created or updated lesson or workspace instead.

## Lesson Navigation

- Every HTML lesson in `learning/{slug}/lessons/` should include a visible backlink to the workspace `index.html`.
- Use a simple label such as `Zpět na rozcestník` or the language of the lesson.
- Keep previous/next lesson links when useful, but do not rely on them as the only navigation.
- Reference HTML files should also link back to related lessons or the workspace index when practical.

## Workspace Shape

- In addition to the teaching workspace files defined by the `teach` skill, create `README.md` and `index.html` for each web-published workspace.
- Keep `README.md` useful for repository navigation, while `index.html` is optimized for the learner opening the public website.
- Update `learning/README.md` when adding a new workspace.

## HTML Expectations

- Lessons and reference documents should be standalone HTML files: no build step, no external local assets required.
- Make pages readable on mobile.
- When a learner will receive a URL directly, make the page self-explanatory without requiring repository context.

## Personalization

- Use known personal context from `people/`, `interests/`, `gear/`, and the workspace `NOTES.md` when it improves motivation or relevance.
- If a personal detail is newly provided and seems durable, record it in the appropriate note as well as in the learning workspace.
- Do not invent personal facts; mark uncertainty or ask.