Skip to content

docs: align the README and package metadata with the roadmap-first product - #97

Merged
Derssa merged 2 commits into
feat/demo-gif-and-completion-fixesfrom
docs/readme-positioning
Sep 4, 2026
Merged

Derssa merged 2 commits into
feat/demo-gif-and-completion-fixesfrom
docs/readme-positioning

Conversation

@OthmaneZ05

Copy link
Copy Markdown
Collaborator

Summary of Changes

README and contributor-docs refresh, so the first screen a visitor sees describes the product as it is today: guided, auto-graded roadmaps on real containers. Stacked on #96, which adds the GIF file.

  • The demo GIF replaces the placeholder comment and the outdated light-theme screenshot.
  • Quick Start describes the current home shell: Start learning on the first-run screen, the Learning tab in the left rail.
  • Catalogue table: Cache-aside with Redis at 45 min, with its new outage step.
  • Website link (torollo.app) next to the npm link under the demo.
  • CONTRIBUTING.md: roadmap authoring listed first, with the in-app import as the way to test a file; Docker Engine or Desktop instead of Desktop only.
  • SECURITY.md: the supported-versions table still said 1.0.x; replaced by "latest npm release and main".
  • Root package.json: description, keywords and homepage aligned with the README.
  • The "ideas" line under Contributing no longer names specific features.

No functional change.

Types of Changes

  • New feature / node type addition
  • Bug fix (non-breaking change resolving an issue)
  • Refactoring / structural cleanup
  • Documentation update

Verification & Testing

Automated Checks

Manual Verification

  • Every relative link in the README resolves on the branch (docs/roadmap-format.md, docs/local-roadmaps.md, docs/learning-api.md, docs/adding-a-node.md, docs/media/torollo-demo.gif, CONTRIBUTING.md).
  • Root package.json still parses; homepage added, files untouched.
  • Quick Start wording checked against the home shell: the first-run hero exposes Start learning and the side rail exposes Learning.

Checklist

  • My code follows the repository's code style and lint standards
  • I have updated the documentation or instructions if necessary
  • All unit and integration tests are passing

@OthmaneZ05
OthmaneZ05 requested a review from Derssa as a code owner September 3, 2026 23:45
@Derssa
Derssa merged commit 15bfde6 into feat/demo-gif-and-completion-fixes Sep 4, 2026
@Derssa
Derssa deleted the docs/readme-positioning branch September 4, 2026 16:28
Derssa pushed a commit that referenced this pull request Sep 4, 2026
…-aside roadmap (#96)

* chore: ignore the local .claude directory

* fix(ui): render modals in a portal and lay out the completion screen in two columns

* fix(network): do not repeat an unchanged audit toast on config saves

* docs: add the demo recording and its reproducible tooling

* feat(learning): recalibrate cache-aside to nine steps and 45 minutes

* docs: align the README and package metadata with the roadmap-first product (#97)

* docs: align the README and contributor docs with the roadmap-first product

* chore: refresh the npm package description, keywords and homepage
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