[SEO] https://docs.dreamfactory.com/: Automated improvements (2026-02-25)#98
Open
nicdavidson wants to merge 2 commits intomainfrom
Open
[SEO] https://docs.dreamfactory.com/: Automated improvements (2026-02-25)#98nicdavidson wants to merge 2 commits intomainfrom
nicdavidson wants to merge 2 commits intomainfrom
Conversation
✅ Deploy Preview for dreamfactory-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
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.
SEO Improvements for https://docs.dreamfactory.com/
Automated analysis identified 20 improvements across 3 priority tiers.
P0 — Critical fixes - highest impact (5 changes)
https://docs.dreamfactory.com/upgrades-and-migrations/upgrading-and-migrating-dreamfactory: Audit flags MULTIPLE H1s: 3 found. Google and AI crawlers use the sole H1 to determine page topic. Multiple H1s dilute topical authority and confuse structured parsing, directly harming ranking for upgrade/migration queries.https://docs.dreamfactory.com/api-generation-and-connections/event-scripts: Audit flags LONG TITLE at 86 chars — the worst offender across all 15 pages. Search results truncate at ~60 chars, so 'DreamFactory Docs' is invisible and the duplicate brand name wastes space. Proposed title is 55 chars and preserves the highest-value keywords.https://docs.dreamfactory.com/api-generation-and-connections/api-types/database/generating-a-database-backed-api: Audit flags LONG TITLE at 75 chars. This is a high-traffic intent page (4177 words, 38 internal links) where SERP truncation actively costs clicks. Proposed title is 59 chars, retains 'no-code' and 'REST API' keywords, and fits within the 60-char target.https://docs.dreamfactory.com/introduction/introducing-rest-and-dreamfactory: Audit flags LONG TITLE at 80 chars. As a key introduction page with 3282 words and 25 internal links, SERP truncation reduces CTR significantly. Proposed title is 49 chars, surfaces the REST+GraphQL value proposition, and eliminates the redundant 'DreamFactory Docs' suffix.https://docs.dreamfactory.com/category/installing-dreamfactory: Audit flags LONG META DESC at 224 chars — 64 chars over the 160-char limit. Search engines truncate the description mid-sentence, wasting the call-to-action. Proposed description is 131 chars, within target, and retains all platform keywords without truncation.P1 — Important improvements (7 changes)
https://docs.dreamfactory.com/api-generation-and-connections/api-types/database/database-overview: Audit flags LONG TITLE at 73 chars. The double brand name ('DreamFactory | DreamFactory Docs') wastes 17 chars. Proposed title is 49 chars, retains the primary keyword 'Supported Database Connectors', and eliminates redundancy.https://docs.dreamfactory.com/getting-started/installing-dreamfactory/helm-installation: Audit flags LONG TITLE at 66 chars. A minimal trim replacing 'DreamFactory Docs' with 'Docs' brings the title to 53 chars without altering any keywords. This page targets a specific technical audience and retains 'Helm Chart' and 'Kubernetes Deployment' intact.https://docs.dreamfactory.com/api-generation-and-connections/api-types/scripting/scripted-services-and-endpoints: Audit flags LONG META DESC at 171 chars. Trimming the redundant 'call external APIs' clause brings it to 131 chars within the 120-160 target while preserving all high-value language keywords (PHP, Python, Node.js, business logic).https://docs.dreamfactory.com/AI/mcp-server: Current title is only 30 chars and lacks descriptive keywords. 'MCP Server' alone provides no context for users or search engines. Adding 'AI Assistant Integration' targets the actual use case described in the page content and improves CTR for AI/developer tooling queries.https://docs.dreamfactory.com: The homepage title duplicates 'DreamFactory Docs' twice, which looks spammy in SERPs and wastes 37 chars on zero-value repetition. The proposed 46-char title introduces REST and GraphQL as primary value keywords, improving both click-through and AI engine topic recognition.https://docs.dreamfactory.com/upgrades-and-migrations/upgrading-and-migrating-dreamfactory: The audit's GEO analysis specifically calls out missing 'Last Updated' timestamps on security and upgrade docs as a trust/E-E-A-T gap. AI engines (Claude, ChatGPT) evaluate freshness signals when citing technical docs, and upgrade guides are high-staleness-risk pages.https://docs.dreamfactory.com/Security/role-based-access: Security documentation is the highest-scrutiny category for E-E-A-T evaluation by AI engines. The audit specifically identifies missing author bylines and last-updated timestamps as a GEO weakness. RBAC is a core enterprise feature page (1224 words, 23 internal links) where trust signals directly affect citation likelihood.P2 — Incremental optimizations (8 changes)
https://docs.dreamfactory.com/api-generation-and-connections/api-types/database/generating-a-database-backed-api: The audit's GEO section identifies missing 'Key Takeaways' callout boxes as a citation opportunity gap. This is the most content-rich page (4177 words, highest word count in the crawl) and a prime candidate for AI engine extraction. Structured summaries improve citation ranking in ChatGPT Search and Perplexity.https://docs.dreamfactory.com/api-generation-and-connections/api-types/database/database-overview: The audit's GEO section explicitly recommends adding 'comparison tables (e.g., Database Connectors: Licensing & Performance)' as a high-impact citation improvement. Structured tables are parsed preferentially by AI engines for factual query responses about database support.https://docs.dreamfactory.com/getting-started/installing-dreamfactory/docker-installation: The GEO analysis states 'Add Prerequisites sections (helps Claude cite you as authoritative starting point).' The Docker installation page has 9 images and 1310 words — it is a heavily-used setup guide where a Prerequisites section also reduces support friction.https://docs.dreamfactory.com/category/installing-dreamfactory: The audit's Technical section flags that category pages should use CollectionPage schema with hasPart references rather than TechArticle. This helps AI engines understand page hierarchy and improves internal linking authority for child installation pages.https://docs.dreamfactory.com/api-generation-and-connections/api-types/scripting/scripted-services-and-endpoints: At 551 words this is the thinnest substantive page in the crawl (excluding the 306-word category page). Thin content pages are deprioritized by both Google and AI engines for citation. Adding Prerequisites and Use Cases sections addresses two explicit GEO recommendations from the audit simultaneously.https://docs.dreamfactory.com/api-reference/api-discovery: The current meta description appears truncated in the audit at 139 chars ending mid-word ('Essen'), suggesting the source value is cut off. The proposed 154-char replacement completes the thought, stays within the 155-char limit, and improves the call-to-action clarity for developer-intent queries.https://docs.dreamfactory.com/system-settings/config/cors-and-ssl: The current meta description appears HTML-entity-encoded and truncated ('Let&#') in the audit data, indicating a rendering or escaping issue in the CMS/frontmatter. The proposed 148-char replacement decodes the entity, completes the sentence, and stays within the 155-char limit.https://docs.dreamfactory.com: The audit identifies ai-train=no as a 'critical flaw' and estimates +15-20% AI search visibility if changed to ai-train=yes. For a developer documentation site with high citation potential (unique technical content on REST API generation, RBAC, MCP), blocking AI training is self-sabotage. Adding explicit bot rules also future-proofs against default-deny interpretations.Generated by Pressroom — AI-powered marketing content engine. Human review required before merge.