Skip to content

Re-write cli doc update workflow - #245

Merged
fibonacci1729 merged 1 commit into
spinframework:mainfrom
ChihweiLHBird:zhiwei/cli-update-workflow
Oct 27, 2026
Merged

fibonacci1729 merged 1 commit into
spinframework:mainfrom
ChihweiLHBird:zhiwei/cli-update-workflow

Conversation

@ChihweiLHBird

Copy link
Copy Markdown
Member

No description provided.

@itowlson itowlson left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thank you for picking this up and making something of it!

exit 1
fi
spin maintenance generate-reference -o "$RUNNER_TEMP/reference.md"
sed -n '1,/^---$/p' "$DOC" > "$RUNNER_TEMP/doc.md"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I would value a brief "how it works" comment around here. My guess is that sed is copying the first few lines of the existing doc and then we are catting the Markdown onto that, but I am not sure. Also not clear to my why we generate-to-a-separate-file-then-cat rather than generate-appending as before. Not that it matters, but for understanding.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yes, this is only a draft for now. Let me refine things

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Hi @itowlson, does it look better now?

@ChihweiLHBird
ChihweiLHBird force-pushed the zhiwei/cli-update-workflow branch from 87c5046 to 26bde5c Compare September 2, 2026 04:46
Signed-off-by: Zhiwei Liang <zhiwei.liang@zliang.me>
@ChihweiLHBird
ChihweiLHBird force-pushed the zhiwei/cli-update-workflow branch from 26bde5c to de06432 Compare September 2, 2026 05:36

@itowlson itowlson left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This looks good to me and should help us with consistency. Thanks!

@itowlson

itowlson commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

@fibonacci1729 You are way bashier than I am, do you have bandwidth to take a quick look please?

@ChihweiLHBird
ChihweiLHBird marked this pull request as ready for review September 14, 2026 04:35
@fibonacci1729
fibonacci1729 merged commit 45daa3e into spinframework:main Oct 27, 2026
3 checks passed
@ChihweiLHBird
ChihweiLHBird deleted the zhiwei/cli-update-workflow branch October 27, 2026 14:40
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.

3 participants