Skip to content

Commit 94a6fd6

Browse files
committed
docs: Add verification guide for website migration
- Methods to check which repository is currently serving - DNS configuration checklist for Cloudflare - Step-by-step migration verification - Troubleshooting guide
1 parent 62b494e commit 94a6fd6

File tree

1 file changed

+138
-0
lines changed

1 file changed

+138
-0
lines changed

VERIFY_MIGRATION.md

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
# Verify Website Migration - Which Repository is Serving?
2+
3+
## Quick Test
4+
5+
To verify which repository is currently serving `reccaller.ai`:
6+
7+
### Method 1: Check GitHub Pages Settings
8+
9+
1. **Check old repository** (`reccaller-ai/reccall`):
10+
- Go to: https://github.com/reccaller-ai/reccall/settings/pages
11+
- Check if custom domain `reccaller.ai` is configured
12+
- If YES → Old repo is still serving
13+
- If NO or Pages disabled → Good!
14+
15+
2. **Check new repository** (`reccaller-ai/websites`):
16+
- Go to: https://github.com/reccaller-ai/websites/settings/pages
17+
- Check if custom domain `reccaller.ai` is configured
18+
- Check if Pages is enabled with "GitHub Actions" source
19+
- If YES → New repo should be serving (after DNS propagation)
20+
21+
### Method 2: Check Website Content
22+
23+
Look for differences between old and new content:
24+
25+
1. **Check homepage for unique content:**
26+
- Old repo might have different version numbers
27+
- New repo has updated content with CLI demo, latest features
28+
29+
2. **Check Git commit timestamps:**
30+
- View page source
31+
- Check for any version indicators or timestamps
32+
33+
### Method 3: Check DNS and GitHub Pages Status
34+
35+
```bash
36+
# Check DNS resolution
37+
dig reccaller.ai +short
38+
39+
# Check GitHub Pages status via API
40+
gh api repos/reccaller-ai/reccall/pages
41+
gh api repos/reccaller-ai/websites/pages
42+
```
43+
44+
## Current Status Analysis
45+
46+
Based on your Cloudflare config showing `contexts` subdomain, but we need to check:
47+
48+
### For Apex Domain (`reccaller.ai`):
49+
50+
**Required DNS Records in Cloudflare:**
51+
- **Type**: `A` records (not CNAME for apex)
52+
- **IP Addresses** (should have 4 records):
53+
- `185.199.108.153`
54+
- `185.199.109.153`
55+
- `185.199.110.153`
56+
- `185.199.111.153`
57+
- **Proxy Status**: Should be "DNS only" (gray cloud) for GitHub Pages
58+
59+
**If you see CNAME for apex domain:**
60+
- That's incorrect - apex domains must use A records
61+
- GitHub Pages will handle the routing based on repository settings
62+
63+
### For `contexts` Subdomain:
64+
65+
Your current config shows:
66+
- **Type**: CNAME ✅
67+
- **Name**: `contexts`
68+
- **Target**: `reccaller.github.io`
69+
- **Proxy**: Proxied (orange cloud) - This is OK for subdomains
70+
71+
## Action Plan
72+
73+
### Step 1: Disable Pages in Old Repository
74+
75+
1. Go to: https://github.com/reccaller-ai/reccall/settings/pages
76+
2. If custom domain `reccaller.ai` is set, **remove it**
77+
3. Or disable Pages entirely if not needed
78+
79+
### Step 2: Enable Pages in New Repository
80+
81+
1. Go to: https://github.com/reccaller-ai/websites/settings/pages
82+
2. Select "GitHub Actions" as source
83+
3. Under "Custom domain", enter: `reccaller.ai`
84+
4. Click "Save"
85+
5. Enable "Enforce HTTPS"
86+
87+
### Step 3: Verify Cloudflare DNS
88+
89+
For `reccaller.ai` (apex domain):
90+
- Should have **4 A records** (not CNAME)
91+
- IPs: `185.199.108.153`, `185.199.109.153`, `185.199.110.153`, `185.199.111.153`
92+
- Proxy: **DNS only** (gray cloud ☁️)
93+
94+
For `www.reccaller.ai` (if used):
95+
- Type: CNAME
96+
- Target: `reccaller-ai.github.io` or your Pages URL
97+
- Proxy: DNS only or Proxied (both work)
98+
99+
### Step 4: Wait and Verify
100+
101+
1. Wait 5-60 minutes for DNS/GitHub changes to propagate
102+
2. Visit https://reccaller.ai
103+
3. Check page source for version indicators
104+
4. Verify HTTPS certificate is issued
105+
106+
## How to Tell Which Repository is Serving
107+
108+
### Old Repository Indicators:
109+
- Older version numbers (v2.1.3 or earlier)
110+
- Missing CLI demo section
111+
- Different layout or content
112+
113+
### New Repository Indicators:
114+
- Latest version (v2.1.4+)
115+
- CLI demo section on homepage
116+
- Updated content from recent PRs
117+
118+
## Troubleshooting
119+
120+
**If site still shows old content:**
121+
1. Clear browser cache (Ctrl+Shift+R or Cmd+Shift+R)
122+
2. Wait longer for DNS propagation
123+
3. Verify GitHub Pages is enabled in new repo
124+
4. Check custom domain is configured correctly
125+
126+
**If site is down:**
127+
1. Check GitHub Pages deployment status
128+
2. Verify DNS records are correct
129+
3. Check custom domain verification in GitHub
130+
131+
## Cloudflare DNS Checklist
132+
133+
- [ ] Apex domain (`reccaller.ai`) has 4 A records (not CNAME)
134+
- [ ] A records point to GitHub Pages IPs (185.199.108.153, etc.)
135+
- [ ] Proxy status for A records is "DNS only" (gray cloud)
136+
- [ ] WWW subdomain (if used) has CNAME to `reccaller-ai.github.io`
137+
- [ ] `contexts` subdomain correctly configured (already done ✅)
138+

0 commit comments

Comments
 (0)