Skip to content

fix: outdent indented numbered-list items (3 tutorials)#2708

Open
jung-thomas wants to merge 1 commit into
mainfrom
fix/issue-193-indented-numbered-items
Open

fix: outdent indented numbered-list items (3 tutorials)#2708
jung-thomas wants to merge 1 commit into
mainfrom
fix/issue-193-indented-numbered-items

Conversation

@jung-thomas

Copy link
Copy Markdown

Summary

Outdents 5 numbered-list items across 3 tutorials so they sit flush with their sibling 1. (or 5.) instead of being interpreted by CommonMark as nested <ol start="N"> items. Detected by tutorials-ims/scripts/lint-tutorial-markdown.ts and tracked in tutorials-ims#193.

This repo's abap-environment-create-cds-mde tutorial was the original report in tutorials-ims#168 — the layout glitch that triggered the platform-side fix and the author-side lint.

Changes (3 tutorials)

Tutorial Lines Fix
abap-environment-create-cds-mde L49, L66 Outdent 2. from 4-space indent to flush-left (matches sibling 1.)
abap-environment-create-rap-business-events L57, L66 Outdent 3. and 4. from 2-space indent to flush-left
abap-environment-extend-cds-view L129 Outdent 6. from 2-space indent to flush-left (matches siblings 1-5)

Per-edit verification: each numbered marker is now flush with its 1. (or matching) sibling. CommonMark continuation content (images, prose, sub-bullets) within each item retains its existing indent so it remains attached to the right list item.

How it was rendered before vs after

Before (CommonMark interpretation):

1. Create a new package
   ![image]
    2. Enter the following:    ← Renders as a NEW <ol start="2">
       - Name: ...

After:

1. Create a new package
   ![image]
2. Enter the following:        ← Continuation of the same list
   - Name: ...

Verification

Run lint-tutorial-markdown against a fresh .tutorial-cache/ after merge — these 3 tutorials should drop off the report.

Related

Sibling numbered-list items 2., 3., 4., and 6. were indented further than
their preceding 1. (or 5.). CommonMark interprets that as a fresh nested
<ol start=N>, which renders as a layout glitch on the new tutorial
platform (sap-tutorials/tutorials-ims#168 — first reported on this very
repo's abap-environment-create-cds-mde tutorial).

Files changed (3 tutorials):
- abap-environment-create-cds-mde: outdent 2. (L49, L66) from 4-space indent to flush-left
- abap-environment-create-rap-business-events: outdent 3. (L57) and 4. (L66) from 2-space indent to flush-left
- abap-environment-extend-cds-view: outdent 6. (L129) from 2-space indent to flush-left (matches siblings 1-5)

Per-edit verification: each numbered marker is now flush with its '1.'
(or matching) sibling. CommonMark continuation content (images, prose,
sub-bullets) within each item retains its existing indent.

Detected by: tutorials-ims/scripts/lint-tutorial-markdown.ts.
Tracking: sap-tutorials/tutorials-ims#193.
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.

1 participant