summaryrefslogtreecommitdiff
path: root/docs/FUTURE_PROOF.md
blob: 73257989ab4e77ec35e400bf77747daa1fedb3f8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# Future Proofing (No Generator)

This site is intentionally hand-edited HTML. The goal here is to keep the *style* the same while making the site easier to maintain and more resilient.

## Principles

- Navigation and core content should work without JavaScript.
- External embeds should always have a plain-link fallback.
- URLs should be stable; if something must move, leave a redirect page.
- Translations should follow a consistent naming rule.

## What We Added

### 1) A real sitemap and robots.txt

- `robots.txt` points to `sitemap.xml`
- `sitemap.xml` is the public crawl map (update when adding new sections)

### 2) A human-friendly site map page

- `/map/` provides a clickable index for humans
- It also links to translated versions

### 3) Translation naming convention

- Default English: `index.html` (or any `page.html`)
- Simplified Chinese: `index_zh.html` (or `page_zh.html`)
- Japanese: `index_jp.html` (or `page_jp.html`)

### 4) Redirect page pattern

If you ever rename or move a page, keep an old file that points to the new place.

Example: create `old-path/index.html`:

```html
<!doctype html>
<meta charset="utf-8">
<meta http-equiv="refresh" content="0; url=/new-path/">
<link rel="canonical" href="/new-path/">
<title>Moved</title>
<p>This page moved to <a href="/new-path/">/new-path/</a>.</p>
```

### 5) Backups

Recommended:

- Put the folder in git (local is enough)
- Mirror the repo remotely (GitHub/GitLab/SourceHut) even if you don’t deploy from it

## Optional Next Step

Add a simple link-check script (offline) to catch broken internal links.