Fix descriptions workflow: flag missing front matter in docs/, unarchive action - #695
Open
fscelliott wants to merge 2 commits into
Open
Fix descriptions workflow: flag missing front matter in docs/, unarchive action#695fscelliott wants to merge 2 commits into
fscelliott wants to merge 2 commits into
Conversation
- Add excerpt/description/title front matter to node and python SDK quickstart pages - check_descriptions.py: flag docs/ files missing metadata.description key entirely (reference/ still silently skips) - add_description.py: insert metadata.description when key is absent, not only when it exists but is empty - Unarchive generate-descriptions.yml and add sync_excerpt.py step so excerpt is populated in the same PR - Bump model ID to claude-sonnet-4-6 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
excerpt,metadata.title,metadata.description, andnexttonode-sdk-quickstart.mdandpython-sdk-quickstart.md, which were missing these fields entirely.check_descriptions.py: Now flagsdocs/files that are missing themetadata.descriptionkey entirely (not just files where the key exists but is empty).reference/files continue to silently skip when the key is absent.add_description.py: Now insertsmetadata.descriptionwhen the key doesn't exist yet, instead of returning early. Previously the workflow could generate a description but silently fail to write it.generate-descriptions.yml: Unarchived from.github/workflows/archive/→.github/workflows/. Added async_excerpt.pystep soexcerptis populated in the same automated PR. Bumped model ID toclaude-sonnet-4-6.Test plan
check_descriptions.pyflags adocs/file with nometadata.descriptionkeycheck_descriptions.pydoes NOT flag areference/file with nometadata.descriptionkeyadd_description.pywrites the description correctly when the key is absent.mdfile and creates a PR🤖 Generated with Claude Code