Skip to content

docs: Document Heretto CMS integration configuration#10

Open
promptless[bot] wants to merge 1 commit intomainfrom
promptless/pr238-heretto-integration
Open

docs: Document Heretto CMS integration configuration#10
promptless[bot] wants to merge 1 commit intomainfrom
promptless/pr238-heretto-integration

Conversation

@promptless
Copy link
Copy Markdown

@promptless promptless bot commented Mar 24, 2026

Open this suggestion in Promptless to view citations and reasoning process

Adds documentation for the new Heretto CMS integration that enables loading content from Heretto CMS for testing. Includes configuration schema, example config with environment variables, and setup requirements (publishing scenario, transtype settings).

Trigger Events

doc-detective/doc-detective PR #238: Implement Heretto content loading functionality

Promptless Research (5 files, 1 GitHub PR)

  • Reviewed doc-detective/doc-detective#238
  • Viewed .long_term_context/product_knowledge/product_overview.md
  • Viewed .long_term_context/doc_workflow/client_instructions.md
  • Viewed .long_term_context/style/client_style_guide.md
  • Viewed skills/doc-detective-project-bootstrap/references/config-guidance.md
  • Viewed skills/doc-detective-doc-testing/SKILL.md

Agent Response

I've reviewed PR #238 and created documentation for the new Heretto CMS integration feature.

Summary

PR #238 adds support for loading content directly from Heretto CMS for testing. Users can now specify heretto:<name> as an input source, and Doc Detective will:

  1. Find the configured publishing scenario in Heretto
  2. Trigger a publishing job to generate DITA output
  3. Poll for completion and download the content
  4. Use that content as test input

Documentation Changes

I created a suggestion that updates config-guidance.md with:

  • New row in the "When to Add Configuration" table for Heretto integration
  • Updated Config TypeScript interface to include integrations.heretto
  • New HerettoConfig interface documenting all configuration properties
  • New "Heretto CMS Integration" section with a complete example config showing:
    • How to use heretto:<name> in the input array
    • Environment variable usage for credentials
    • Requirements for Heretto publishing scenario setup

I also updated the product overview in long_term_context to document this as a supported integration.

Suggestion URL: https://app.gopromptless.ai/suggestions/a32874db-5a03-4baf-abde-d94aaa44d5da


Tip: Planning a big docs refactor? Use Deep Analysis to get help with the heavy lifting 🔍

concurrentRunners?: number; // Default: 1
logLevel?: "silent"|"error"|"warning"|"info"|"debug"; // Default: "info"
integrations?: { // External CMS integrations
heretto?: HerettoConfig[];
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Citation: Added HerettoConfig interface based on PR #238 which implements the Heretto content loading functionality. Configuration properties derived from src/core/integrations/heretto.ts and the loadHerettoContent function parameters.
View source


### Heretto CMS Integration

Load content directly from Heretto CMS for testing. Use `heretto:<name>` in your `input` array to reference a configured Heretto integration:
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Citation: Heretto CMS integration example based on PR #238. The heretto:<name> input syntax is handled in src/core/detectTests.ts, and requirements (transtype: dita, publishing scenario) come from findScenario function validation in src/core/integrations/heretto.ts.
View source

@promptless promptless bot marked this pull request as ready for review March 25, 2026 23:05
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.

0 participants