Add better error 404 handling to the docs

[Sipher]

Summary by CodeRabbit

• New Features
  • Introduced a custom 404 page for clearer guidance when pages aren’t found.
• Performance
  • Enabled gzip compression and long-term caching for static assets to speed up page loads.
• Security
  • Added security headers (X-Frame-Options, X-Content-Type-Options, X-XSS-Protection) for safer browsing.
• Build/Chores
  • Container now uses a custom Nginx configuration by default to optimize static site serving.
• Documentation
  • Added a 404 documentation page with guidance, helpful links, and a user feedback section.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

Introduces a custom Nginx configuration, copies it into the container via Dockerfile, and adds a 404 documentation page. The Nginx config defines gzip, security headers, caching for static assets, a try_files root handler, and a custom 404 page.

Changes

Cohort / File(s)	Summary
Container build setup Dockerfile	Copies nginx.conf to /etc/nginx/conf.d/default.conf before adding app assets, ensuring the container uses the provided Nginx configuration.
Web server configuration nginx.conf	Adds Nginx server block on port 80 with gzip, security headers, try_files routing, long-term caching for static assets, and a custom 404 page.
Docs and content src/content/docs/404.mdx	Adds a 404 documentation page with frontmatter, an image, navigation links, and feedback instructions using a local component and asset.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor User
  participant Nginx
  participant StaticFiles as /usr/share/nginx/html

  User->>Nginx: GET /path
  alt File exists
    Nginx->>StaticFiles: try_files $uri
    StaticFiles-->>Nginx: file
    Nginx-->>User: 200 OK<br/>Cache-Control: public, immutable (for assets)
  else Not found
    Nginx->>StaticFiles: /404.html
    StaticFiles-->>Nginx: 404 page
    Nginx-->>User: 404 Not Found<br/>Custom 404 page
  end

  note over Nginx: Sends security headers and gzip if eligible

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

A hop, a skip, I tweak the breeze—
Nginx now serves with airy ease.
Cached carrots (assets) crisp and bright,
A 404 sign lit at night.
In Docker’s burrow, configs nest—
I thump: “It’s routed, zipped, and dressed!” 🥕🚀

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch dev

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between a877c63 and dfae994.

⛔ Files ignored due to path filters (1)

• src/assets/travolta-lost.gif is excluded by !**/*.gif

📒 Files selected for processing (3)

• Dockerfile (1 hunks)
• nginx.conf (1 hunks)
• src/content/docs/404.mdx (1 hunks)

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}