Generate API Markdown

Generate an API markdown file and token file using ApiView. Use this when the user wants to generate an API markdown file and review API changes.

Azure Updated

File contents

Generate API Markdown

Prerequisites

  1. Activate your virtual environment.
  2. Install the required dependencies:
    cd <repo_root>
    pip install -e ./eng/tools/azure-sdk-tools
    

Instructions

  1. Navigate to the desired package directory
  2. Run the command:
    azpysdk apistub .
    
  3. The command generates api.md and api.metadata.yml in the package directory, which are the files needed to pass the API consistency check. Provide these files to the user for review.
  4. If the user explicitly asks for the raw APIView token file, run azpysdk apistub . --token-file instead.

Azure/azure-sdk-for-python/tree/main/.github/skills/generate-api-markdown commit 5d55e93748

Frequently asked questions

npx skillmds@latest add azure-azure-sdk-for-python/generate-api-markdown