Skip to content

Commit 25afa72

Browse files
committed
feature: polished up the highlevel overview document
1 parent fbf0422 commit 25afa72

File tree

3 files changed

+8
-6
lines changed

3 files changed

+8
-6
lines changed

advanced/subpath/route53-cloudfront.mdx

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,20 +10,21 @@ To host your documentation at a `/docs` subpath using AWS Route 53 and CloudFron
1010

1111
## High-level overview
1212

13-
CloudFront must allow traffic to these specific paths without caching or blocking:
13+
Route traffic to these paths with a Cache Policy of **CachingDisabled**:
1414

1515
- `/.well-known/acme-challenge/*` - Required for Let's Encrypt certificate verification
1616
- `/.well-known/vercel/*` - Required for domain verification
17-
- `/docs/*`
18-
- `/docs/`
17+
- `/docs/*` - Required for subpath routing
18+
- `/docs/` - Required for subpath routing
1919

20-
and these paths with caching enabled:
20+
Route traffic to this path with a Cache Policy of **CachingEnabled**:
2121

2222
- `/mintlify-assets/_next/static/*`
23+
- `Default (*)` - Your websites landing page
2324

24-
These paths should be configured to bypass CloudFront caching and pass through directly to your origin.
25+
All Behaviors must have the an **origin request policy** of `AllViewerExceptHostHeader`.
2526

26-
All paths must use the `AllViewerExceptHostHeader` origin request policy to ensure redirects are properly handled.
27+
![CloudFront "Behaviors" page with 4 behaviors: `/docs/*`, `/docs`, `Default`, and `/.well-known/*`.](/images/cloudfront/all-behaviors.png)
2728

2829
## Create CloudFront distribution
2930

advanced/subpath/vercel.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,7 @@ Your external proxy must allow traffic to these specific paths without blocking,
5151

5252
- `/.well-known/acme-challenge/*` - Required for Let's Encrypt certificate verification
5353
- `/.well-known/vercel/*` - Required for Vercel domain verification
54+
- `/mintlify-assets/_next/static/*` - Required for static assets
5455

5556
These paths should pass through directly to your Vercel deployment without modification.
5657

20.8 KB
Loading

0 commit comments

Comments
 (0)