arkmq-org / arkmq-org/markdown-runner

autocompletion should list stages by appearance order in the tutorial

Open
#26 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
Go
Stars
0
Forks
2
PR merge metrics
No merged PRs in 30d

Description

the autocompletion returns the list of stages to break at sorted by alphabetical order:

```
└──╼> markdown-runner docs/tutorials/prometheus_locked_down.md --break-at
certs deploy grafana init messaging scrape teardown test_setup verify
```

Which is not practical to know where to stop if you're aiming for the previous to the last one for instance.

Contributor guide

No contributing guide indexed for this repository

Research direction

Run the shown markdown-runner command and trace the --break-at autocompletion entry point. Compare its current alphabetical output with the stage order in docs/tutorials/prometheus_locked_down.md; done means the suggestions follow their appearance order so users can identify the preceding stage.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
cli
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.