Skip to content

Commit 7d7cb9d

Browse files
committed
Target protobuf-net.dev instead of protogen.marcgravell.com
An apex domain cannot use a CNAME record, so the DNS setup is A/AAAA records (or ALIAS/ANAME) rather than a subdomain CNAME; the README now carries the actual records. Also corrects what web/public/CNAME does: with artifact-based deploys the file does not set the domain by itself - the repo's Pages setting does. The first deploy proved this, having left the setting null with the file present.
1 parent 874c8a8 commit 7d7cb9d

2 files changed

Lines changed: 32 additions & 5 deletions

File tree

‎README.md‎

Lines changed: 31 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# protogen site
22

3-
The site behind **[protogen.marcgravell.com](https://protogen.marcgravell.com)**: generate C# and
3+
The site behind **[protobuf-net.dev](https://protobuf-net.dev)**: generate C# and
44
VB.NET from `.proto` schemas, and pull apart raw protobuf payloads without a schema.
55

66
Everything runs in the browser. There is no server, no API and no upload — schemas and payloads
@@ -54,13 +54,40 @@ Three details that matter for Pages:
5454
domain and under the `/protogen-site/` subpath of the default `*.github.io` URL. Anything that
5555
resolves the .NET runtime at load time must go through `import.meta.env.BASE_URL`; a leading
5656
slash silently breaks the subpath case.
57-
- `web/public/CNAME` carries the custom domain. It only takes effect once the domain is set in
58-
the repo's Pages settings *and* DNS has a `CNAME` record for `protogen` pointing at
59-
`protobuf-net.github.io`.
57+
- `web/public/CNAME` names the custom domain. With artifact-based deploys this file does not by
58+
itself change anything — the domain in the repo's Pages settings is what takes effect. Keep them
59+
in agreement.
6060
- `web/public/.nojekyll` stops Jekyll stripping the `_framework` directory, which would otherwise
6161
be ignored for starting with an underscore. The artifact-based deploy does not run Jekyll, but
6262
the file guards against a future switch to branch-based publishing.
6363

64+
### DNS for the apex domain
65+
66+
`protobuf-net.dev` is an apex (naked) domain, so it cannot use a `CNAME` record — that is only
67+
valid for subdomains. Point it at GitHub's Pages addresses instead:
68+
69+
```
70+
A protobuf-net.dev 185.199.108.153
71+
A protobuf-net.dev 185.199.109.153
72+
A protobuf-net.dev 185.199.110.153
73+
A protobuf-net.dev 185.199.111.153
74+
75+
AAAA protobuf-net.dev 2606:50c0:8000::153
76+
AAAA protobuf-net.dev 2606:50c0:8001::153
77+
AAAA protobuf-net.dev 2606:50c0:8002::153
78+
AAAA protobuf-net.dev 2606:50c0:8003::153
79+
```
80+
81+
If the DNS host supports `ALIAS`/`ANAME` at the apex, a single record to `protobuf-net.github.io`
82+
is preferable — it tracks GitHub's addresses if they ever change.
83+
84+
Optionally add `CNAME www protobuf-net.github.io`; GitHub redirects `www` to the apex.
85+
86+
`.dev` is on the HSTS preload list, so browsers will only ever load this over HTTPS. GitHub
87+
provisions the certificate automatically once DNS resolves; until then the site is unreachable on
88+
the custom domain, which is why the domain should be set in Pages settings *after* the records
89+
are live.
90+
6491
## Scope
6592

6693
**C# and VB.NET only.** The old site also offered C++, Java, JavaScript, Objective-C, PHP, Python

‎web/public/CNAME‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
protogen.marcgravell.com
1+
protobuf-net.dev

0 commit comments

Comments
 (0)