Generating documentation from collections in Postman - Interactive Code Practice

Practice - 5 Tasks

1fill in blank

easy

Complete the code to export a Postman collection as JSON.

Postman

JSON.[1](pm.collection.toJSON())

Drag options to blanks, or click blank then click option'

Asave

Bstringify

Cexport

Dparse

Attempts:

3 left

💡 Hint

Common Mistakes

Using 'save' instead of 'stringify' causes errors because 'save' is not a JSON method.

Using 'parse' tries to convert a string to an object, which is the opposite of what we want.

The toJSON() method returns a JavaScript object representing the collection. To convert it to a JSON string for documentation or export, use stringify.

2fill in blank

medium

Complete the code to generate documentation for a Postman collection.

Postman

pm.collection.generateDocumentation([1])

Drag options to blanks, or click blank then click option'

Afalse

Bnull

Ctrue

D{}

Attempts:

3 left

💡 Hint

Common Mistakes

Passing 'true' or 'false' causes type errors because the method expects an object.

Passing 'null' results in no documentation generated.

The generateDocumentation method requires an options object. Passing an empty object {} uses default settings to generate documentation.

3fill in blank

hard

Fix the error in the code to correctly export collection documentation as HTML.

Postman

const doc = pm.collection.generateDocumentation({ format: 'html' });
pm.environment.set('docHTML', [1]);

Drag options to blanks, or click blank then click option'

Adoc.toString()

BdocHTML

Cdoc

Ddoc.html

Attempts:

3 left

💡 Hint

Common Mistakes

Using 'docHTML' causes a reference error because it is undefined.

Using 'doc.toString()' is unnecessary since 'doc' is already a string.

The variable doc already contains the generated HTML string. Setting the environment variable with doc stores the HTML correctly.

4fill in blank

hard

Fill both blanks to create a script that saves collection documentation to a file.

Postman

const fs = require('[1]');
fs.writeFileSync('collection-doc.html', [2]);

Drag options to blanks, or click blank then click option'

Afs

Bfs-extra

Cdoc

Ddocumentation

Attempts:

3 left

💡 Hint

Common Mistakes

Using 'fs-extra' requires an extra package and is not standard.

Using 'documentation' instead of 'doc' causes a reference error.

Node.js uses the fs module to write files. The documentation content is stored in the variable doc, which should be written to the file.

5fill in blank

hard

Fill all three blanks to generate Markdown documentation and save it to a variable.

Postman

const [1] = pm.collection.generateDocumentation({ format: '[2]' });
const markdownDoc = [3];

Drag options to blanks, or click blank then click option'

AmdDoc

Bmarkdown

DmarkdownDoc

Attempts:

3 left

💡 Hint

Common Mistakes

Using 'markdownDoc' as the first variable causes confusion.

Setting format to 'md' or other strings causes errors.

The variable mdDoc stores the generated Markdown documentation. The format option should be set to 'markdown'. Then assign mdDoc to markdownDoc for clarity.

Practice

1. What is the main benefit of generating documentation from Postman collections?

easy

A. It only works for public APIs, not private ones.

B. It requires manual writing of all API details.

C. It saves time and reduces errors by automating documentation.

D. It replaces the need for testing APIs.

Solution

1. Step 1: Understand the purpose of documentation generation

   Generating docs from collections automates the process, reducing manual work and mistakes.

2. Step 2: Compare options with this purpose

   Only It saves time and reduces errors by automating documentation. correctly states the benefit of saving time and reducing errors.

3. Final Answer:

   It saves time and reduces errors by automating documentation. -> Option C

4. Quick Check:

   Automation saves time and errors [OK]

Hint: Remember: automation reduces manual errors and saves time [OK]

Common Mistakes:

• Thinking documentation must be written manually
• Believing docs replace API testing
• Assuming docs only work for public APIs

2. Which Postman feature allows you to add explanations to each API request for better documentation?

easy

A. Pre-request scripts

B. Environment variables

C. Test scripts

D. Request descriptions

Solution

1. Step 1: Identify how to add explanations in Postman

   Request descriptions let you write notes or explanations for each API request.

2. Step 2: Match options to this feature

   Only 'Request descriptions' directly relate to adding explanations for documentation.

3. Final Answer:

   Request descriptions -> Option D

4. Quick Check:

   Descriptions explain requests [OK]

Hint: Descriptions add notes to requests for docs [OK]

Common Mistakes:

• Confusing test scripts with documentation notes
• Using environment variables for explanations
• Thinking pre-request scripts add descriptions

3. Given a Postman collection with detailed request descriptions, what will happen when you generate documentation from it?

medium

A. The documentation will include the request descriptions automatically.

B. Descriptions must be added manually after generating docs.

C. Only request names appear; descriptions are ignored.

D. Documentation cannot be generated from collections.

Solution

1. Step 1: Understand how Postman uses request descriptions

   Postman includes request descriptions automatically in generated documentation.

2. Step 2: Evaluate each option

   The documentation will include the request descriptions automatically. correctly states that descriptions appear automatically; others are incorrect.

3. Final Answer:

   The documentation will include the request descriptions automatically. -> Option A

4. Quick Check:

   Descriptions auto-included in docs [OK]

Hint: Descriptions appear automatically in generated docs [OK]

Common Mistakes:

• Assuming manual addition of descriptions after generation
• Thinking descriptions are ignored
• Believing docs can't be generated from collections

4. You tried to publish documentation from a Postman collection, but the descriptions are missing. What is the most likely cause?

medium

A. Descriptions were not added to the requests before publishing.

B. The collection was not saved before publishing.

C. Postman does not support publishing documentation.

D. You need to write descriptions in test scripts.

Solution

1. Step 1: Identify why descriptions might be missing

   If descriptions are missing, likely they were never added to requests.

2. Step 2: Check other options for correctness

   Saving collection is important but usually does not remove descriptions; Postman supports publishing; test scripts do not hold descriptions.

3. Final Answer:

   Descriptions were not added to the requests before publishing. -> Option A

4. Quick Check:

   Missing descriptions mean none were added [OK]

Hint: Add descriptions before publishing docs [OK]

Common Mistakes:

• Forgetting to add descriptions before publishing
• Confusing test scripts with descriptions
• Thinking Postman can't publish docs

5. You want to share your API documentation with your team and keep it updated automatically when the collection changes. What is the best way to do this in Postman?

hard

A. Export the collection as JSON and email it to the team.

B. Publish the documentation from the collection and share the published link.

C. Copy and paste the collection details into a Word document.

D. Take screenshots of the collection and share images.

Solution

1. Step 1: Identify how to share and keep docs updated

   Publishing documentation creates a live link that updates automatically with collection changes.

2. Step 2: Evaluate other options

   Exporting JSON or copying details are manual and do not update automatically; screenshots are static.

3. Final Answer:

   Publish the documentation from the collection and share the published link. -> Option B

4. Quick Check:

   Published docs auto-update and share easily [OK]

Hint: Use published docs link for auto-updated sharing [OK]

Common Mistakes:

• Sharing static files instead of live docs
• Assuming exported JSON is readable documentation
• Using screenshots which do not update