repo-website-api-update

Update API documentation to match Formisch source code changes.

1.1k|32|Updated Apr 5, 2025
One-click install
npx skills add https://github.com/open-circle/formisch --skill repo-website-api-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-website-api-update
Source: https://github.com/open-circle/formisch/tree/main/skills/repo-website-api-update
Command: npx skills add https://github.com/open-circle/formisch --skill repo-website-api-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures API documentation stays synchronized with Formisch source changes, preventing drift between code and docs.

Core Features & Use Cases

  • Documentation synchronization: Automatically align API references with updated function signatures, interfaces, and JSDoc comments.
  • Impact analysis: Identify affected doc sections and guide targeted updates across core packages and website docs.
  • Use Case: After a library change, run the update workflow to refresh API pages and examples so they reflect the current implementation.

Quick Start

Run the update procedure after modifying source code to regenerate API docs and verify consistency across all references.

Frequently Asked Questions about repo-website-api-update

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

FAQPage Schema
How do I keep API documentation in sync with source code changes?

API documentation synchronization validates updated function signatures, interfaces, and JSDoc comments against the actual source code implementation. This enforces alignment between source files and website references to prevent documentation drift.

When do I need to update API docs after modifying library code?

You need to update API docs after modifying library code whenever core packages undergo function signature changes, interface updates, or JSDoc edits. Running the synchronization workflow refreshes API pages and examples to reflect the current implementation accurately.

What is the best way to align JSDoc comments with updated function signatures?

Aligning JSDoc comments with updated function signatures requires a validation process that checks signatures, types, and descriptions across all API reference sections. An impact analysis identifies affected doc sections to guide targeted updates across core packages and website docs.

Does this documentation synchronization workflow cover API reference examples too?

Yes, documentation synchronization covers all API reference sections and associated examples. By validating signatures and types, the workflow ensures that both the descriptive text and code examples reflect the current source implementation.

How to identify which documentation sections need updates after a code change?

To identify which documentation sections need updates after a code change, perform an impact analysis on the modified core packages. This analysis guides targeted updates by locating all API references and examples affected by the signature or interface modifications.