update-docs

Automate documentation synchronization with code changes in Next.js workflows.

Updated Sep 6, 2024
One-click install
npx skills add https://github.com/Jaylaelike/pm25-interactive-thaipbs-app --skill update-docs-jaylaelike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-docs
Source: https://github.com/Jaylaelike/pm25-interactive-thaipbs-app/tree/main/.claude/skills/update-docs
Command: npx skills add https://github.com/Jaylaelike/pm25-interactive-thaipbs-app --skill update-docs-jaylaelike

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps maintainers keep project documentation aligned with code changes by guiding and automating the documentation update process during PR reviews and feature developments.

Core Features & Use Cases

  • Change analysis mapping: Analyzes code diffs and maps affected files to relevant documentation sections using the repository's mapping guidelines.
  • Guided update workflow: Provides a step-by-step workflow to review, update, lint, and validate docs before merging.
  • Automation readiness: Supports running lint checks and commit-ready documentation preparations for PRs.

Quick Start

  1. Analyze changes on the active branch with git diff canary...HEAD --stat.
  2. Identify affected docs using references/CODE-TO-DOCS-MAPPING.md and prepare updates.
  3. Validate formatting with pnpm lint and commit your documentation updates.

Frequently Asked Questions about update-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep documentation in sync with code changes during a PR?

To keep documentation in sync with code changes, analyze your branch diff using git diff canary...HEAD --stat, map the affected files to the relevant docs using your repository's code-to-docs mapping guidelines, and then update the documentation sections before merging.

What is the best way to automate documentation updates for Next.js workflows?

The best way to automate documentation updates is to follow a structured workflow that analyzes code diffs, maps the changes to specific documentation sections, and validates the formatting with a lint check before preparing the final commit.

How does diff analysis map code changes to specific documentation sections?

Diff analysis maps code changes to documentation sections by comparing branch differences, identifying the modified files, and cross-referencing them with a dedicated mapping guideline file to determine exactly which documentation entries require updates.

Does this documentation update workflow run lint checks before committing?

Yes, the documentation update workflow runs lint checks to validate formatting. It enforces a structured process that includes diff analysis, doc mapping, updates review, linting validation, and commit preparation to ensure docs are accurate before merging.

Can I use this guided workflow to prepare documentation commits for pull requests?

Yes, you can use this guided workflow to prepare documentation commits for pull requests. It provides step-by-step instructions to review changes, update the necessary docs, run lint validation, and prepare the final documentation updates for your PR.

Why do I need a code-to-docs mapping file to update my project documentation?

You need a code-to-docs mapping file to accurately identify which documentation sections correspond to specific code changes. It serves as a reference guideline during diff analysis, ensuring that no affected documentation is missed when updates occur.