Skip to content

Conversation

a-kenji
Copy link
Contributor

@a-kenji a-kenji commented Jul 24, 2025

Closes: #410

a-kenji added 2 commits July 24, 2025 19:16
Add `mdsh` directive to the cli documentation, to make it easier to keep
in sync.

How to run:
```
nix run n#mdsh -- --inputs ./docs/cli.md
```
@a-kenji a-kenji requested a review from Enzime July 24, 2025 19:01
@@ -1,14 +1,19 @@
# CLI

<!-- `$ nix run . -- --help` -->
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What's this for?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's in the commit message. It's to easily keep the cli documentation up to date.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that mean running the command in the commit message will automatically update this file?

We already have mdsh configured under treefmt so does that mean our checks.<system>.treefmt will now error if it's out of date?

Copy link
Contributor Author

@a-kenji a-kenji Jul 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that mean running the command in the commit message will automatically update this file?

Yes, running the command will automatically update the file and keep it up to date.

We already have mdsh configured under treefmt so does that mean our checks..treefmt will now error if it's out of date?

No, and we could remove mdsh from treefmt as it seems unused to me.
But we could set it up to error if it's out of date.

@Mic92 Mic92 added this pull request to the merge queue Jul 29, 2025
Merged via the queue into nix-community:main with commit 837dd09 Jul 29, 2025
4 checks passed
@a-kenji a-kenji deleted the ke-update-cli-docs branch July 29, 2025 09:04
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.

docs: cli.md outdated / missing --phases
3 participants