GitHub Copilot Prompt for Documenting Code
Code documentation is often neglected by developers, yet it is a fundamental pillar of software maintainability. GitHub Copilot, integrated directly into your code editor, turns this time-consuming task into a smooth and nearly instant process. By analyzing your code context — function names, parameters, return types, internal logic — Copilot generates relevant comments, docstrings, and technical documentation in seconds. Whether you are working on a REST API, an open-source library, or a corporate project, a well-crafted prompt enables Copilot to produce structured, consistent documentation that adheres to your language's conventions (JSDoc, Python docstrings, Javadoc, etc.). The challenge is not simply to describe what the code does, but to capture the why — architectural decisions, edge cases, business constraints. With the right prompts, Copilot becomes a true technical co-writer capable of significantly accelerating your documentation workflow without sacrificing quality.
Paste in your AI
Paste this prompt in ChatGPT, Claude or Gemini and customize the variables in brackets.
Document this function by adding a complete documentation block in the standard format of the language used. Include: a concise description of the function's purpose, each parameter with its type and role, the return value with its type, possible exceptions or errors, a concrete usage example, and any notes on edge cases or side effects. Adopt a professional and technical tone. If the function is part of a public API, specify usage constraints and the version since which it is available.
Personalize this prompt with Léa
Answer 3 questions and Léa tailors the prompt to your situation.
Why this prompt works
This prompt is effective because it provides a clear structure that Copilot can follow point by point, eliminating any ambiguity about the expected content. By mentioning the standard format of the language, it automatically adapts to the context (JSDoc, docstring, Javadoc). Including advanced elements like edge cases and side effects pushes Copilot beyond superficial documentation toward truly useful documentation.
Use Cases
Variants
Expected Output
Copilot generates a complete documentation block formatted according to the language's conventions, with a clear description, typed and documented parameters, return value, possible exceptions, and a usage example. The produced documentation is ready to be integrated directly into the source code and compatible with documentation generators like Sphinx, TypeDoc, or Javadoc.
Frequently Asked Questions
Can GitHub Copilot document code in any programming language?
Yes, GitHub Copilot supports documentation in the vast majority of common programming languages. It automatically generates the appropriate format based on the detected language: JSDoc for JavaScript/TypeScript, docstrings for Python, Javadoc for Java, XML comments for C#, rustdoc for Rust, and so on. Quality is especially high for the languages most represented in its training data (Python, JavaScript, TypeScript, Java, Go). For less common languages, it's recommended to explicitly specify the desired documentation format in your prompt.
How can I ensure that the documentation generated by Copilot is accurate and free of hallucinations?
Documentation generated by Copilot should always be reviewed and validated by the developer. Three best practices reduce the risk of inaccuracy: first, provide as much context as possible by keeping related files open in your editor. Second, use descriptive variable and function names—Copilot relies heavily on these semantic cues. Third, always check type descriptions, return values, and generated examples by comparing them against the actual code. Hallucinations are more common in behavioral descriptions than in structural elements like parameter types.
Is it better to use Copilot Chat or inline suggestions to document code?
Both approaches are complementary. Inline suggestions (by typing /** or """ above a function) are ideal for function-by-function documentation within a continuous development flow—it's fast and contextual. Copilot Chat is preferable when you need to document an entire file, generate a README, create architectural documentation, or finely customize the style and level of detail via a well-crafted prompt. For substantial projects, combine the two: use Chat to define documentation conventions, then inline to apply them throughout the code.
Learn more
Check the full skill on Prompt Guide to master this technique from A to Z.
View on Prompt Guide📬 Get new prompts every week
Join our newsletter and never miss a prompt.
Similar Prompts
Generate Mocks and Fixtures for Your Automated Tests
A prompt to automatically generate realistic mocks, stubs and data fixtures adapted to your test framework and use cases.
Automatically Generate Unit Tests with AI
Automatically generate an exhaustive unit test suite covering nominal cases, edge cases, and error cases for any source code.
Create a Python Automation Script
Create a professional Python automation script with CLI configuration, structured logging, error handling, and tests.
Analyze and Optimize Algorithmic Complexity
Analyze the Big O complexity of your algorithms and optimize them with appropriate data structures and more efficient algorithms.