Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Parts of only one lesson #304

Copy link
Copy link
@eric-burel

Description

@eric-burel
Issue body actions

Is your feature request related to a problem?

I'd like to write intro/outro parts that may not need a 3-level subdivision between part, chapter and lesson.

Currently, I need multiple levels so my introduction page maybe /getting-started/intro/about", instead of just /getting-started`. The UX is not as smooth as it could when it comes to writing proper course introductions or conclusions.

Describe the solution you'd like.

Allow having 2-levels or 1-level hierarchy.

intro
|_ _files
|_ content.md
|_ meta.md
short-part
|_ chapter-1
|__ _files
|__ content.md

Describe alternatives you've considered.

This seems a little change but I understand how this can affect UX.

  • We could allow having content in parts and chapters ? Maybe have special "intro.md"/"ending.md" files ?
  • Or keep content only in type "lesson", but allow a lesson to live outside of a chapter or part ? In this approach, as a default, we write lessons in a tutorial. Optionally, we can move lessons to a chapter. And optionnaly, we can move chapters into parts.
  • We could instead craft independant Astro pages, and focus on linking them to specific courses via meta data? For instance adding an "outro: /some-page" field to the chapter definition or something alike. But seems convoluted, mixing the mental model of Astro and the mental model of Tutorialkit.

Additional context

The file packages/astro/src/default/utils/routes.ts seems to be responsible to route creation and could be tweaked quite easily. However such a change may have consequences on the mental model around parts/chapters/lessons in other places.

Reactions are currently unavailable

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      Morty Proxy This is a proxified and sanitized view of the page, visit original site.