PCPP1 Best Practices And Coding Conventions Practice Question
When writing a library, what is the best practice for documenting the usage of a function?
Answer choices
Why each option matters
Answer the question above first, then reveal the full breakdown to understand why each option is right or wrong.
Correct answer & explanation
✓
Use docstrings to provide a clear summary and usage details.
Docstrings provide the most standard and accessible form of documentation that can be integrated with tools like Sphinx.
Answer analysis
Option-by-option breakdown
For each option: why learners choose it and why it is or isn't the right answer here.
- ✗
Include the documentation as comments above the function definition.
Why it's wrong here
Comments are for internal implementation details, not API documentation.
- ✓
Use docstrings to provide a clear summary and usage details.
Why this is correct
Docstrings are the built-in standard for Python documentation.
- ✗
Provide usage examples in the 'README.md' file only.
Why it's wrong here
While helpful, it is not a replacement for code-level documentation.
- ✗
Wait for users to ask for documentation.
Why it's wrong here
Professional libraries require proactive documentation.
About these practice questions
One of 209 original PCPP1 practice questions on Courseiva, each with a full explanation and wrong-answer analysis — not exam dumps or protected exam content. Learn why practice questions differ from exam dumps →
JA
Written and reviewed by Johnson Ajibi, MSc IT Security
Senior Network & Security Engineer · founder of Courseiva
Last reviewed August 2026 · checked against the official Python Institute exam blueprint
This PCPP1 practice question is part of Courseiva's free Python Institute certification practice question bank. Courseiva provides original exam-style practice questions with explanations, topic-based practice, mock exams, readiness tracking, and study analytics to help learners prepare for the PCPP1 exam.