docs: restructure integrations to mirror LP categories and add tier ranking#2506
Draft
marcel-rbro wants to merge 3 commits intomasterfrom
Draft
docs: restructure integrations to mirror LP categories and add tier ranking#2506marcel-rbro wants to merge 3 commits intomasterfrom
marcel-rbro wants to merge 3 commits intomasterfrom
Conversation
…ranking Reorganize sources/platform/integrations/ so that folders mirror the categories on apify.com/integrations and each integration's sidebar_position encodes a tier (1 = S, 2 = Mid, 3 = Other). MCP moves into Built-in alongside API, Actors, and Webhooks. Slugs are unchanged, so no URLs change and no redirects are required. Refs #2505
Rename eight markdown files to use hyphens instead of underscores so filename style matches existing slug conventions: - integrate_with_apify.md - ai-sdks-frameworks/aws_bedrock.md - ai-sdks-frameworks/openai_agents.md - ai-sdks-frameworks/openai_assistants.md - vector-db-storage/airtable/console_integration.md - built-in/actors/integration_ready_actors.md - built-in/actors/integrating_actors_via_api.md - built-in/webhooks/ad_hoc_webhooks.md URL change: /integrations/aws_bedrock -> /integrations/aws-bedrock (only slug that previously contained an underscore). Add a redirect upstream if needed. Refs #2505
Promote GitHub to a Built-in integration alongside API, Actors, Webhooks, and MCP. Drop the now-empty Developer tools category. Slug `/integrations/github` is unchanged, so no redirects are required. Also fix broken markdown links left over from the underscore-to-hyphen filename rename: `integrate_with_apify.md` and `integration_ready_actors.md`. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #2505
Summary
sources/platform/integrations/into folders that mirror apify.com/integrations.ai/mcp/).sidebar_position:1= S-tier,2= Mid,3= Other. Within a tier, items order alphabetically.Tier ranking
Source: prioritization input from Lukas Bekr.
New folder structure
built-in/workflow-automation/workflows-and-notifications/ai-assistants/ai-sdks-frameworks/ai/collaboration/data-pipelines/data-storage/vector-db-storage/developer-tools/payments/other/LP categories without docs (Coding agents & IDEs, App builders, GTM tools, MCP gateways, iPaaS, Productivity) are out of scope here - tracked in the issue for follow-up.
Implementation notes
git mvto retain history.sources/platform/storage/{dataset,key_value_store,request_queue}.md,sources/platform/actors/development/{actor_definition,permissions}/index.md,sources/platform/actors/development/index.md,sources/platform/actors/running/actor_standby.md.index.mdxrewritten to mirror the LP and to surface S-tier first within each section.pnpm buildpasses locally; no new broken-link errors.Test plan
/platform/integrations/api,/integrations/mcp,/integrations/n8n,/integrations/github,/integrations/airtablemaster🤖 Generated with Claude Code