docs: dynamic abbreviations with markdown tables #99

2026-08-06T19:25:09Z

rootiest commented

2026-08-06 19:25:09 +00:00

Summary:
This PR finalizes the abbreviation documentation feature. It unifies shell aliases and bash-style history expansions into the abbreviations documentation generation pipeline. To satisfy MDX component-rendering requirements (used in Starlight), abbreviations are now rendered as standard markdown tables rather than indented pre-formatted text blocks.

Manual Verification Checklist:

Run npm run dev in docs/site and verify the 04-abbreviations.mdx page renders without any MDX/React errors.
Review docs/manual/04-abbreviations.md to ensure the structure correctly relies on the newly generated tables.
Execute config-help (or bat on docs/fish-config.md) in the terminal to verify the raw tables format nicely in fallback environments.

**Summary:** This PR finalizes the abbreviation documentation feature. It unifies shell aliases and bash-style history expansions into the abbreviations documentation generation pipeline. To satisfy MDX component-rendering requirements (used in Starlight), abbreviations are now rendered as standard markdown tables rather than indented pre-formatted text blocks. **Manual Verification Checklist:** - [x] Run `npm run dev` in `docs/site` and verify the `04-abbreviations.mdx` page renders without any MDX/React errors. - [x] Review `docs/manual/04-abbreviations.md` to ensure the structure correctly relies on the newly generated tables. - [x] Execute `config-help` (or `bat` on `docs/fish-config.md`) in the terminal to verify the raw tables format nicely in fallback environments.

rootiest added 8 commits 2026-08-06 19:25:10 +00:00

feat(jobrunner): add named background job manager backed by GNU screen 674a50ea05

Adds jobrunner (short alias jr) for running, listing, inspecting,
re-attaching to, and terminating detached background tasks. Unlike bkg
and detach, which discard output, a jobrunner job keeps a live terminal
that survives closing the shell and can be restored later with attach.

Includes the __jobrunner_sessions parser shared by the function and its
completions, dynamic job-name completions, and screen in the fish-deps
catalog.

feat: implement __rand_string generator and update jobrunner to use tmux ffff95f3b9

refactor: drop __ prefix and add -h flag to rand_string 01553b71fd

feat: add verb dictionary and preserve literal string casing in rand_string d5535a38ad

feat: implement jobrunner auto-naming fallback 0e9c3b4b27

refactor: use -n flag for explicit jobrunner names 89fdfc8e72

fix: change jobrunner auto-naming to adjective-animal cb74cd84e2

docs: use markdown tables for abbreviations 742fd7941d

Generates actual markdown tables instead of indented text blocks to ensure MDX/Starlight correctly renders abbreviations.

rootiest added 1 commit 2026-08-06 19:38:22 +00:00

docs: restructure abbreviations into individual pages for sidebar 82d761b026

rootiest added 1 commit 2026-08-06 20:00:55 +00:00

docs: use indented text tables for abbreviations and strip CardGrid from concat 204b13781d

rootiest added 1 commit 2026-08-06 20:07:16 +00:00

docs: fix abbreviations file ordering and capitalization for tests e76668d3b1

rootiest added 2 commits 2026-08-06 20:10:08 +00:00

ci: remove obsoleted docs-drift workflow 6790bf1430

ci: move workflow to .github to increase hosting compatibility 86d20105e5

rootiest added 1 commit 2026-08-06 20:10:55 +00:00

Merge branch 'main' into feature/dynamic-abbreviations-docs 0ff6be3f81

rootiest merged commit 262b53c6c4 into main

2026-08-06 20:10:57 +00:00

rootiest deleted branch feature/dynamic-abbreviations-docs

2026-08-06 20:10:58 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: rootiest/fish-config#99