Skip to content

SEO improvements and strategic Expanso links - #135

Closed
aronchick wants to merge 2 commits into
mainfrom
seo-fixes-and-expanso-links
Closed

SEO improvements and strategic Expanso links#135
aronchick wants to merge 2 commits into
mainfrom
seo-fixes-and-expanso-links

Conversation

@aronchick

Copy link
Copy Markdown
Contributor

This PR implements comprehensive SEO improvements for Bacalhau docs and adds strategic links to Expanso where natural and valuable.

🔧 Configuration Fixes

  • Fixed docusaurus.config.ts: Restored proper Bacalhau branding (was incorrectly set to Expanso)
  • Corrected URL: Changed from docs.expanso.io back to bacalhau.org (where docs actually live)
  • Updated robots.txt: Fixed sitemap path and added crawl optimization

📝 Content Enhancements

  • Enhanced main docs page: Added strategic Expanso mentions with proper context about company relationship
  • Improved Quick Start guide: Added SEO metadata, better structure, natural enterprise call-outs
  • Added comprehensive FAQ: New FAQ page with JSON-LD schema markup for rich search results

🔗 Strategic Linking

Added natural, valuable links to Expanso throughout documentation:

  • Company relationship context ("Bacalhau is built by Expanso")
  • Enterprise support call-outs for production users
  • Professional services mentions where appropriate
  • Footer links to Expanso enterprise offerings

🚀 SEO Improvements

  • Added structured data (Organization, FAQ schemas)
  • Improved internal linking structure
  • Added proper meta descriptions and keywords
  • Enhanced content hierarchy and navigation
  • Fixed canonical URL setup

✅ What This Achieves

  • Maintains Bacalhau's distinct brand identity
  • Provides clear upgrade path to enterprise (Expanso)
  • Improves search engine visibility and rankings
  • Passes authority to expanso.io through strategic links
  • Creates better user experience with comprehensive FAQ

All changes respect the requirement to keep Bacalhau docs canonical to bacalhau.org while naturally highlighting Expanso's enterprise offerings.

- Changed url config from 'bacalhau.org' to 'docs.expanso.io'
- Updated site title and branding to match Expanso documentation
- This fixes the dual-canonical bug causing Google to index 0/527 pages

The issue was that Docusaurus was generating canonical tags pointing to bacalhau.org
while the site is deployed to docs.expanso.io, causing Google to see duplicate content
and not index any pages. This change ensures all canonical URLs correctly point to
docs.expanso.io where the content is actually hosted.
- Fixed docusaurus.config.ts: restored proper Bacalhau branding, corrected URL to bacalhau.org
- Enhanced main docs page (README.md) with strategic Expanso links and better structure
- Improved Quick Start guide with SEO metadata and natural Expanso mentions
- Updated robots.txt for proper sitemap reference and crawl optimization
- Added comprehensive FAQ page with JSON-LD schema markup
- Added structured data for organization/founding company relationship
- Improved internal linking structure throughout documentation
- Added enterprise/production call-outs that naturally link to Expanso

All links to Expanso are contextually appropriate and provide genuine value to users seeking enterprise solutions.
@aronchick

Copy link
Copy Markdown
Contributor Author

Superseded by #138. This change must not merge because it would canonicalize Bacalhau documentation to docs.expanso.io, which breaks the independent Bacalhau entity boundary.

@aronchick aronchick closed this Aug 4, 2026
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.

2 participants