Skip to content

Conversation

@maglietti
Copy link
Contributor

IGNITE-27450: Suggested Site Update for Apache Ignite Website

Summary

This PR provides the suggested-site/ directory containing the combined Apache Ignite website with integrated documentation for both Ignite 2.x and Ignite 3.x.

Test URLs

Main Site

  • Homepage: /
  • Download: /download/
  • Community: /community/
  • Blog: /blog/
  • Events: /events/
  • FAQ: /faq/
  • Resources: /resources/

Documentation Landing

  • Docs selector: /docs/
  • Latest redirect: /docs/latest/ (redirects to Ignite 3)

Ignite 3 Documentation (Docusaurus)

  • Latest: /docs/ignite3/latest/
  • Versioned: /docs/ignite3/3.1.0/
  • Quick Start: /docs/ignite3/3.1.0/getting-started/quick-start/

Ignite 2 Documentation (Jekyll)

  • Latest: /docs/ignite2/latest/
  • Versioned: /docs/ignite2/2.17.0/
  • Quick Start: /docs/ignite2/2.17.0/quick-start/java

Feature Pages

  • SQL: /features/sql/
  • Native Persistence: /arch/native-persistence/

Known Issues and Expectations

Ignite 2 URLs and .html Extensions

The Ignite 2 documentation was built with Jekyll, which generates .html files but uses sidebar links without the extension (clean URLs). On Apache servers, .htaccess rules handle this automatically. For static hosting or local testing:

  • Both /docs/ignite2/2.17.0/quick-start/java and /docs/ignite2/2.17.0/quick-start/java.html work
  • The serve.py script provides a Python HTTP server with .html extension fallback for local testing
  • Production Apache configuration should include the existing .htaccess rules for clean URL support

Version Aliases

  • /docs/latest/ redirects to /docs/ignite3/3.1.0/ (Ignite 3 is the canonical latest)
  • /docs/ignite2/latest/ is sym-linked to 2.17.0 for testing
  • /docs/ignite3/latest/ redirects and is sym-linked to 3.1.0 for testing

Testing

Local Testing

To serve the suggested-site locally:

python3 serve.py 3000 suggested-site

Or use any static file server that supports directory index and .html fallback.

Verification Checklist

  • Homepage loads with navigation
  • Download page shows current releases
  • Docs landing page offers Ignite 2/3 selection
  • Ignite 3 docs load with working sidebar
  • Ignite 2 docs load with working sidebar and version selector
  • Blog posts render with syntax highlighting
  • Feature pages load correctly
  • Search functionality works (Pagefind for Ignite 2, built-in for Ignite 3)

Copy link
Contributor

@IgGusev IgGusev left a comment

Choose a reason for hiding this comment

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

Looks ok. Suggested-site now includes everything, which is a lot and might have issues, but should be fully isolated from user-facing site.

@sk0x50 sk0x50 merged commit de3ff92 into apache:master Jan 8, 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.

3 participants