Documentation 3 Automated API Documentation

Sub-skill of documentation: 3. Automated API Documentation (+2).

vamseeachanta 25bee8c 949 B Updated

File contents

3. Automated API Documentation (+2)

3. Automated API Documentation

# Generate API docs from docstrings
"""
Module description.

Example:
    >>> import mymodule
    >>> mymodule.function()
    'result'
"""

*See sub-skills for full details.*

## 4. Version Documentation


```bash
# Version docs with releases
version_docs() {
    local version="$1"

    # MkDocs with mike
    mike deploy "$version" latest -u
    mike set-default latest

    # Docusaurus
    npm run docusaurus docs:version "$version"
}

5. Link Validation

# Check for broken links
check_links() {
    local docs_dir="${1:-docs}"

    # Using markdown-link-check
    find "$docs_dir" -name '*.md' -exec markdown-link-check {} \;

    # Using linkchecker on built site
    linkchecker ./site/index.html
}

vamseeachanta/workspace-hub/tree/main/.agents/skills/_archive/development/documentation/documentation/3-automated-api-documentation commit 25bee8cec8

Frequently asked questions

npx skillmds@latest add vamseeachanta/documentation-3-automated-api-documentation