Skip to content

Conversation

@khaliqgant
Copy link
Member

@khaliqgant khaliqgant commented Oct 17, 2025


Add Advanced Integration Pattern Guides to Documentation

This pull request introduces a new 'Advanced Integration Patterns' section to the documentation by adding six comprehensive implementation guides which cover advanced sync/action use cases. The new guides-configuration-based-sync, selection-based-sync, window-time-based-sync, action-leveraging-sync-responses, 24-hour-extended-sync, and multi-model-sync-are provided as individual .mdx files detailing best practices, code patterns, edge cases, and pitfalls for each scenario. Additionally, necessary updates are made to docs.json to organize and surface these new guides within the sidebar navigation structure.

Key Changes

• Added docs/implementation-guides/building-integrations/configuration-based-sync.mdx explaining custom syncs using metadata-driven configuration.
• Added docs/implementation-guides/building-integrations/selection-based-sync.mdx describing user-defined resource selection sync pattern.
• Added docs/implementation-guides/building-integrations/window-time-based-sync.mdx for time-windowed batch data ingestion.
• Added docs/implementation-guides/building-integrations/action-leveraging-sync-responses.mdx covering actions that utilize synced data.
• Added docs/implementation-guides/building-integrations/24-hour-extended-sync.mdx documenting approach for long-running, resumable syncs under execution limits.
• Added docs/implementation-guides/building-integrations/multi-model-sync.mdx showing multi-entity synchronization pattern.
• Updated docs/docs.json to introduce an 'Advanced Integration Patterns' group referencing all new pattern guides.

Affected Areas

• docs/implementation-guides/building-integrations/configuration-based-sync.mdx
• docs/implementation-guides/building-integrations/selection-based-sync.mdx
• docs/implementation-guides/building-integrations/window-time-based-sync.mdx
• docs/implementation-guides/building-integrations/action-leveraging-sync-responses.mdx
• docs/implementation-guides/building-integrations/24-hour-extended-sync.mdx
• docs/implementation-guides/building-integrations/multi-model-sync.mdx
• docs/docs.json


This summary was automatically generated by @propel-code-bot

@linear
Copy link

linear bot commented Oct 17, 2025

@rguldener
Copy link
Member

@khaliqgant I won't have time for a full review today, I think, but see some things that will need tweaks (e.g. nav structure).

Please hold off from merging, thanks!

@khaliqgant
Copy link
Member Author

@khaliqgant I won't have time for a full review today, I think, but see some things that will need tweaks (e.g. nav structure).

Please hold off from merging, thanks!

Got it. No problem! The content is mostly unchanged from the integration templates fwiw

@github-actions
Copy link
Contributor

This PR is stale because it has been open for 30 days with no activity.

@github-actions github-actions bot added the Stale label Nov 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants