Skip to content

Refine dynamic mock doc#4817

Open
yaoweiprc wants to merge 1 commit intomainfrom
insomnia-dynamic-mock
Open

Refine dynamic mock doc#4817
yaoweiprc wants to merge 1 commit intomainfrom
insomnia-dynamic-mock

Conversation

@yaoweiprc
Copy link
Copy Markdown

Description

  1. Updated the page description and introduction to accurately reflect that dynamic mocking uses the Liquid template language (instead of generic "templates").
  2. Replaced references to "Faker template tags" with "faker variables" to align with the actual implementation terminology.
  3. Replaced the old "Template reference examples" section title with "Template syntax" for clarity.
  4. Added a clear explanation of the two built-in Liquid variables available at request time: req and faker.
  5. Added a direct link to the faker variables reference in the Insomnia Mockbin source: run.js#L218.
  6. Updated Liquid tag reference links to use the English LiquidJS docs (liquidjs.com/tags/...) instead of the Chinese locale.
  7. Added a note that only the default filter is supported for filters.
  8. Minor prose improvements for grammar and precision.

I think the "test options for a mock route in the Insomnia app" section is not related to dynamic mocking — it covers general mock functionality and should be moved to a different page.

Fixes #issue

Preview Links

Checklist

  • Tested how-to docs. If not, note why here.
  • All pages contain metadata.
  • Any new docs link to existing docs.
  • All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
  • Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
  • Every page has a description entry in frontmatter.
  • Add new pages to the product documentation index (if applicable).
  • [ ]

@yaoweiprc yaoweiprc requested a review from a team as a code owner April 10, 2026 10:01
Copilot AI review requested due to automatic review settings April 10, 2026 10:01
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 10, 2026

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit e8d043f
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/69d8ca8af8731800087ec904
😎 Deploy Preview https://deploy-preview-4817--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates Insomnia dynamic mocking documentation to more precisely describe the Liquid-based templating model and faker-driven data generation used when rendering mock responses.

Changes:

  • Refines the dynamic mocking page to explicitly describe Liquid templates, the built-in req/faker variables, and supported tags/filters.
  • Updates terminology from “Faker template tags” to “faker variables” and refreshes Liquid documentation links.
  • Aligns the mock servers landing page copy with the updated Liquid/faker terminology.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
app/insomnia/dynamic-mocking.md Clarifies dynamic mocking as Liquid template rendering at request time, documents req/faker, supported tags, and references.
app/_landing_pages/insomnia/mock-servers.yaml Updates landing page “Dynamic mocking” copy to reference Liquid and faker variables.

Comment on lines 56 to +57
Use simple Liquid conditions to vary the response based on the request.
Only a limited set of Liquid tags are supported for safety.
Only a limited set of Liquid tags is supported for safety.
Copy link

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Subject–verb agreement: since “tags” is plural, change this to either “Only a limited subset of Liquid tags is supported for safety.” or “Only a limited set of Liquid tags are supported for safety.”

Copilot uses AI. Check for mistakes.
Dynamic mocking expands Insomnia’s mock servers with templates that generate context-aware and realistic responses.
Each response is rendered server-side by the mock server using templates with a safe, restricted tag set.
Insomnia also provides **Faker template tags** for generating random names, dates, and other test data at runtime.
Dynamic mocking expands Insomnia’s mock servers with the Liquid template language that generate context-aware and realistic responses.
Copy link

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Grammar: “the Liquid template language that generate …” should be “the Liquid template language that generates …” (or rephrase to “using the Liquid template language to generate …”).

Suggested change
Dynamic mocking expands Insomnia’s mock servers with the Liquid template language that generate context-aware and realistic responses.
Dynamic mocking expands Insomnia’s mock servers with the Liquid template language that generates context-aware and realistic responses.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants